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Preface 



Use this publication as a reference manual; 
it contains all of the command formats, 
syntax rules, and operand and option 
descriptions for CHS commands, subcommands, 
and macro instructions for general users. 



The IBM Virtual 
CMS UserJ^s GuideT 
contains tutorial 
functional descripti 
well as information 
EXEC, and debugging 
should be familiar w 
user's guide before 
reference manual, 
commands described i 
may find additional 
user's guide. 



Machine Facilitv^370: 

Order' No? GC 2 0-18 19, 

information and 

ons of CMS commands, as 

on using the editor, 
facilities of CMS. You 
ith the contents of the 
you attempt to use this 

For most of the CMS 

n this publication, you 

useful notes in the 



This publication has six sections: 

"Section 1. Introduction and General 
Concepts" describes the components of the 
VM/370 system and tells you how to enter 



the notational 

manual, so that 

command format 

Section 1 also 

the CMS command 



CMS commands. It lists 

conventions used in this 

you can interpret the 

descriptions in Section 2. 

contains information about 

search order and a summary of all the CMS 

commands available under VM/370, including 

those not for general users. 



"Section 2. CMS Commands" contains 
complete format descriptions, and operand 
and option lists, for the CMS commands 
available to general users. Each command 
description contains usage notes, and lists 
responses and error messages (with 
associated return codes) produced by the 
command. 

"Section 3. EDIT Subcommands and Macros" 
describes the subcommands and macros 
available in the environment of the CMS 
Editor, which you can invoke with the EDIT 
command. Each subcommand description 
contains usage notes and summarizes the 
types of responses you might receive. 
Where applicable, additional information is 
provided for users of display terminals. 



"Section 4. DEBUG Subcommands" describes 
the subcommands available in the debug 
environment of CMS. Each subcommand 
description contains usage notes and, where 
applicable, lists the responses to the 
subcommand. 



"Section 5. EXEC Control Statements" 
describes the control statements, special 
variables, and built-in functions you can 
use when you create EXEC procedures to 
execute in CMS. The control statement 
descriptions contain usage notes, where 
applicable. 

"Section 6. CMS Macro Instructions" 
lists the formats and operands of the CMS 
assembler language macro instructions you 
can use when you write programs to execute 
in CMS. 



This publication 
appendixes: 



also 



has 



three 



"Appendix A: Reserved Filetype Defaults" 
lists the filetypes that are recognized by 
the CMS Editor and indicates the default 
settings that the editor supplies for 
logical tabs, truncation, verification, 
logical record length, and so on. 

"Appendix B: DCS/VS Access Method 
Services and VSAM Functions Not Supported 
in CMS" lists the restrictions on the use 
of Access Method Services and VSAM in the 
CMS/DOS environment of CMS. 

"Appendix C: OS/VS Access Method 
Services and VSAM Functions Not Supported 
in CMS" lists the restrictions for OS 
programmers using Access Method Services 
and VSAM in CMS. 
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Some of the following terms are used, for 
convenience, throughout this publication: 

• The term "CMS/DOS" refers to the 
functions of CMS that become available 
when you issue the command 

set dos on 

CMS/DOS is a part of the normal CMS 
system, and is not a separate system. 
Users who do not use CBS/DOS are 
sometimes referred to as OS users, since 
they use the OS simulation functions of 
CMS. 

• The term "CMS files" refers exclusively 
to files that are in the 800-byte block 
format used by CMS file system commands. 
VSAM and OS data sets and DOS files are 



not compatible with the CHS file format, 
and cannot be manipulated using CHS file 
system commands. 

The terms "disk" and "virtual disk" are 
used interchangeably to indicate disks 
that are in your CHS virtual machine 
configuration. Where necessary, a 
distinction is made between 
CHS-formatted disks and disks in OS- or 
DCS format. 

• "3270" refers to both the IBH 3275 
Display Station, Hodel 2 and the IBH 
3277 Display Station, Hodel 2. 

• "3330" refers to the IBH 3330 Disk 
Storage Hodels 1, 2, and 11, the IBH 
3333 Disic Storage and Control Hodels 1 
and 11, and the IBH 3350 Direct Acsess 
Storage in 3330 compatibility mode. 

• "2305" refers to the IBH 2305 Fixed Head 
Storage, Hodels 1 and 2. 

• "3340" refers to the IBH 3340 Direct 
Access Storage Facility and the IBH 3344 
Direct Access Storage. 

• "3350" refers to the IBH 3350 Direct 
Access Storage device when used in 
native mode. 

• Any information pertaining to the IBH 
2741 terminal also applies to the IBH 
3767 terminal, unless otherwise noted. 

Ho£§: Information on the IBH 3344 and 3350 

Direct Access Storage Devices is for 

planning purposes only until the 
availability of the products. 

For a glossary of VH/370 terms, see the 
IBH Virtual Ha chine F ac ility/3 7 : Glossary 
anl llsIIl""lSIII7 Qrder~No7~"GC20-18"l3. 



££§£§<iuisite Publications 

In addition to the VH/370: CHS User's 
Guide, prereguisite information is 
contained in the following publications: 

• For information about the terminal that 
you are using, including procedures for 
gaining access to the VH/370 system and 
logging, on, see the IBH Virtual Hachine 
l3cility/370; Terminal User's Guide, 
OrdeFllo.' GC20-"l8"ToT 

If you are using an IBH 3767 
Communications Terminal, the IBH 3767 
Operator's Guide, Order No. GaTI-2000 , 
is a prereguisite. 

• The CP commands that are available to 
you as a general user are described in 



IM Virtual Hachine Facility/370: CP 
Command Seferen.ce for General Users, 
Order" No. GC20-"l820. 

For additional tutorial information on 
using CHS, you may want to use CHS for 
Programmers - A Primer, Order No. 
SB20-44387" 

If you are going to use an IBH Program 
Product compiler under CHS, you should have 
available the appropriate program product 
documentation. These publications are 
listed in IBH Virtual Hachine Facilitj/370: 
Introduction. 



55£63JJlSii§ PjJkilSSiions 

The IBH Virtual Hachine F a c i li tx/3 7 : 
Sjstei H@§§M£S' Order No. GC20-1808, 
describes all of the error messages and 
system responses produced by the CHS 
conoands and EDIT and DEBUG subcommands 
referenced in this publication. It also 
lists the error messages issued by the EXEC 
processor during execution of your EXEC 
procedures. 

If you are using CHS to prepare and 
develop job streams to run under other 
virtual machines in VH/370, you should 
consult IBH Virtual Hachine Facilitj/370: 
Operating Systems in a Virtual Hachine, 
Order No. GC20-1821. 



Belated VH/370 Publications 

For general information about the VH/370 
system, see the publications IBH Virtual 
Machine Facilitjj/370: Introduction, Order 
NoT " GC20-1800, "and yH/370 Features 
Supplement, Order No. GC20-T757. 

Additional descriptions of various CHS 
functions and commands which are normally 
used by system support personnel are 
described in 

IEJ Virtual Hachine Facility/370: 

System Programmer's Guide, Order No. 
GC20-1807 

2£§f3i2£ls Guide, Order No. GC20-1806 

Planning and System Generation Guide, 
Order No. GC20-1801 

Interactive Problem Control System 
llPC I7"oiir I Guide"5r der~No . ~GC 20-182 3 

Environmental Recording, Editing, and 
Printing (EREP) "Projgram, Order No. 
GC 2 9- 83 00. 



There are two publications available as 
ready reference material when you use 
VM/370 and CMS. They are IBM Virtual 
Machine Fac il i ty/3 7 : 



0,uick Guide for Users, Order 
GX20-1926 



No. 



Command Reference Summary, Order No. 
GX20-"l96l7 

If you are going to use the Remote 
Spooling Communications Subsystem, see the 
ISH Virtual .Machine Facil ity/3 7 : Remote 
SE2°.li!12 Communications Subsystem (RSCS) 
fislill Guide7~Order~NoT""GC20-18 : l6. 

Assembler language programmers may find 
information about the VM/370 assembler in 
QS/VS, DOS/VS, and VM/370 Assembler 
Language, Order No." GC33-40T0, and OS/VS 
HHd VM/370 Assembler Programmer's Guide, 
Order~No7""GC33-402TT 

Related Publications for VSAM and Access 
HfsiJjod. Services Users 

CMS support of Access Method Services is 
based on DOS/VS Access Method Services. The 
control statements that you can use are 



described in DOS/VS Access Method Services 
DserJI.s Guide,"" Order No7" GC3 3-5 3827 The 
VM/370: CMS User Is Guide contains details 
on how to use this support. Error messages 
produced by the Access Method Services 
program, and return codes and reason codes 
are listed in DOS/VS Messages, Order No. 
GC33-5379. 

For a detailed description of DOS/VS 
VSAM macros and macro parameters, refer to 
the DOS/VS Supervisor and I/O Macros, Order 
Nc. GC33-5373. For information on OS/VS 
VSAM macros, refer to Ojji/VS Virtual Storage 
Access Method (VSAM) programmer's "Guide, 
0rder"No7~GC26-38l8. ~ " 



Related Publications for CMS/DOS Users 

The CMS ESERV command invokes the DOS/VS 
ESEBV program, and uses, as input, the 
control statements that you would use in 
DOS/VS. These control statements are 
described in Guide to the DOS/VS Assembler, 
Order No. GC33 Z U024. 

Linkage editor control statements, used 
when invoking the DOS/VS linkage editor 
under CMS/DOS, are described in DOS/VS 
System Control Statements, Order No. 
GC33-5376. 



Summary of Amendments 

for GC20-1818-0 

VM/370 Release 3 PLC 1 



CMS SIMULATES FUNCTIONS OF DOS/VS 



New: Program Feature 

The Conversational Monitor System (CMS) 
now simulates many of the functions of 
the Disk Operating System/VS (DOS/VS) to 
allow interactive development, testing, 
and debugging of DOS programs in a 
special superset of the CMS command 
environment, called CMS/DOS. 



This publication incorporates the 
following changes to reflect this 
support: 



The SET command 
operands: 



has three 



new 



— DOS, which invokes the CMS/DOS 
environment and optionally 
identifies the DOS/VS system 
residence volume to be used during 
a terminal session. 

— UPSI, which allows you to set the 
UPSI (User Program Switch 
Indicator) byte for programs that 
use and test it. 

— DOSPART, which allows you to set a 
virtual partition size for programs 
to execute in CMS/DOS. 

These three operands have 
corresponding QUERY command operands, 
so that you can test their current 
settings. 

The following commands have been 
added to simulate DOS/VS job control 
and librarian functions: 



ASSGN 


ESERV 


PSERV 


DLBL 


FETCH 


RSERV 


DOSLKED 


LISTIO 


SSERV 


DSERV 


OPTION 





The QUERY command has DLBL and OPTION 
operands, so you can test the file 
definitions and options set with the 
DLBL and OPTION commands. 

CMS simulates DOS/VS core image 

libraries in CMS libraries called 

DOSLIBS. The CMS commands that 
recognize DOSLIBs are: 



— DOSLIB 

— GLOBAL (DOSLIB operand) 

—QUERY (DOSLIB and LIBRARY operands) 

A new EXEC special variable, 6D0S, 
allows you to interrogate the status 
of the CMS/DOS environment. 

The GENMOD command has new options, 
DOS, OS, or ALL, that indicate 
whether the CMS/DOS environment 
should or should not be active when a 
MODULE file is executed. 

The LOADMOD command checks, when a 
MODULE file is loaded, that the 
proper environment is active. 



CMS READS AND WRITES VSAM DATA SETS 



New: Program Feature 

You can use CMS to manipulate VSAM data 
sets with DOS/VS Access Method Services 
and execute programs written in the 
COBOL, PL/I, and VS BASIC programming 
languages that read and write VSAM data 
sets. The following commands are new or 
changed to support CMS VSAM: 

• The AMSERV command in CMS invokes 
Access Method Services to manipulate 
VSAM catalogs and data sets. Access 
Method Services control statements 
must be contained in a CMS file with 
a filetype of AMSERV. 

The AMSERV filetype is recognized by 
the CMS Editor. 

• The DLBL command establishes file 
identifications for VSAM data sets 
for OS and DOS users. Special 
options are provided for use with 
VSAM data sets: VSAM, CAT, EXTENT, 
MULT, and BUFSP. 

• The LISTDS command has two new 
options, EXTENT and FREE, which 
provide you with information 
concerning allocated and unallocated 
extents on OS and DOS disks. 

You can query the status of all 
accessed OS and DOS disks with the 
LISTDS command. 



The SET DOS ON command has a VSAM 
option for CMS/DOS users who are 
going to invoke Access Method 
Services or read and write VSAM data 
sets. 

Responses to the following CMS 
commands now indicate whether a disk 
is an OS or DOS disk, and whether it 
is accessed in read-only (R/0) or 
read/write (R/W) status: 

ACCESS 

QUERY SEARCH 
QUERY DISK 



CMS SUPPORTS DISCONTIGUOUS SAVED SEGMENTS 



New: Program Feature 

CMS now loads and releases saved systems 
beyond the end of user storage. The CMS 
SET command has a new operand, SYSNANE, 
that allows you to specify the name of 
the system that you want loaded, and an 
additional operand, NONSHARE, that 
allows you to specify that you want your 
own copy of a named system. 

The QUERY command has a SYSNAMES operand 
so that you can determine what system 
names are currently in effect for your 
virtual machine. 



CHANGES TO THE EXEC INTERPRETER 



character symbols, as well as 
mneumonics, for the comparison 
operators: 

Symbol Mnemonic Meaning 
= EQ eguals 
-■= NE does not egual 
< LT less than 
<= LE less than or 

egual 
> GT greater than 
>= GE greater than or 

egual 

EXEC can now perform hexadecimal to 
decimal and decimal to hexadecimal 
conversion when a token begins with 
the characters X*. A hexadecimal 
value can be converted to its decimal 
eguivalent in an assignment 
statement; in any other statement, a 
decimal value is converted to its 
hexadecimal eguivalent. 



There are three new EXEC control 
statements: 

— SHEX, which initiates or inhibits 
hexadecimal conversion in an EXEC. 

— &EMSG, which allows you to display 
error messages in accordance with 
the current CP EMSG settings. 

— 6BEGEMSG, which introduces one or 
more lines of error messages that 
are not scanned by the EXEC 
interpreter. 



Changed: Programming and Documentation 

The CMS EXEC processor now executes in 
the discontiguous saved segment named 
CMSSEG. The following enhancements have 
been made to EXEC: 

• EXEC can now read variable-length 
files, to a maximum of 130 
characters. In fixed-length EXEC 
files, only columns 1 through 72 are 
processed, but in variable-length 
files, records are processed for 
their entire length. 

The CMS Editor defaults the record 
format of EXEC files to variable 
length. 

• The SIF and SLOOP statements 
recognize the following special 



The following new special variables 
have been added: 

— SDOS, which indicates whether or 
not the CMS/DOS environment is 
active (ON or OFF) 

— SDISKx, which indicates, for the 
disk accessed as mode •x*, whether 
the disk is CMS, OS, DOS, or not 
accessed (NA) . 

— &DISK*, which contains the mode 
letter of the read/write disk with 
the most space, or NONE if there 
are no read/write disks accessed. 

— &DISK?, which contains the mode 
letter of the first read/write disk 
in the standard search order, or 
NONE if no read/write disks are 
accessed. 



PUBLICATION REWRITTEN 



MISCELLANEOUS CHANGES 



New: Documentation Only 

This publication contains information 
formerly in the following publications: 

• CHS command formats and assembler 
language macro descriptions, formerly 
in IBM Virtual Machine Facili ty/3 70 : 
Command Language Guide for General 
Users, are contained in "Section 2. 
CMS Commands" and "Section 6. CMS 
Macro Instructions." 

• EDIT subcommand descriptions, 
formerly in IBM Virtual Machine 
lacilit y/3 7 : EDIT Guide, are in 
"Section 3. EDIT Subcommands and 
Macros." 

• EXEC control statement, special 
variable, and built-in function 
descriptions, formerly in IBM Virtual 
Machine Faci 1 i ty/ 3 7 : EXEC Userjs 
Guide, are in "Section 5. EXEC 
Control Statements." 

• DEBUG subcommand descriptions, 
formerly in the VM/370: System 
EE°iI£ammerJ_s Guide, are in "Section 
4. DEBUG Subcommands." 



Command format and operand descriptions 
have been rewritten to standardize the 
formats; notes have been added to 
clarify command or subcommand usage, 
with examples, where appropriate. 
Technical changes and additions to the 
commands and subcommands are indicated 
by revision bars in the left margin. 



Detailed descriptions of error messages 
and responses from the editor, EXEC 
processor, and debug program are in 
VMZ170: System Messages. 



Changed: Programming and Documentation 
There are two new CMS commands: 

• STATEH, which is described with the 
STATE command. STATED performs the 
same function as the STATE command, 
but verifies whether a file exists on 
a read/write disk. 

• TAPEMAC, which reads OS macro 
libraries from tape created by the 
IEHMOVE utility program and creates a 
CMS MACLIB file directly from the 
tape. 

The following additions or changes have 
been made to existing CMS commands: 

• The RELEASE command has a new option, 
DET, which detaches the disk from 
your virtual machine configuration. 
The RELEASE command now results in 
the user file directory being sorted 
and rewritten on disk. This change 
also affects the ERASE option of the 
ACCESS command and the NOUPDIRT 
option of the RENAME command. 

• The SYNONYM command no longer clears 
existing synonyms by default. You 
must use the CLEAR option to clear a 
synonym table. When you enter the 
SYNONYM command with no options, a 
list of current synonyms is 
displayed. 

A new CMS macro instruction, FSCBD, 
which generates a DSECT for the CMS file 
system control block (FSCB) is 
documented in "Section 6. CMS Macro 
Instructions." 

Numerous minor corrections have been 
made to the format descriptions of CMS 
commands, EDIT subcommands, and EXEC 
control statements, to clarify usage. 

Messages and return codes produced by 
CMS commands have been updated. 
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Section 1. Introduction and General Concepts 



Virtual Machine Facility/370 (VM/370) is a system control program (SCP) 
that controls "virtual machines." A virtual machine is the functional 
equivalent of a real machine, but where the real machine has lights to 
show status , and buttons and switches on the real system console to 
control it, the virtual machine has a virtual system console to display 
status and a command language to start operations and control them. The 
virtual system console is your terminal; there are three command 
languages, which correspond roughly to the four components of the VM/370 
system: 

• The Control Program (CP) controls the resources of the real machine; 
that is, the physical machine in your computer room. The CP commands 
are described in VM/370: CP Command Ref©£®Ii£§ l2£ General Users. 

• The Remote Spooling Communications Subsystem (RSCS) is a subsystem 
designed to supervise transmission of files across a teleprocessing 
network controlled by CP. For information about RSCS, see the 
VM/370: Remote Spooling Communications Subsystem (RSCS) Dser2.s 
G ui d e . 

• The Conversational Monitor System (CMS) is a conversational operating 
system designed to run under CP. All of the CMS commands for general 
use, and the subcommands and macros that you can use in the CMS 
environment, are described in this publication. 

• The Interactive Problem Control System (IPCS) provides system 
programmers and installation support personnel with VM/370 problem 
analysis and management facilities, including problem report 
creation, problem tracking, and CP abend dump analysis. IPCS runs in 
the CMS command environment; for details, see VM/370: IPCS Oser^s 
Guide . 

Except for IPCS, each of the components of VM/370 has a unique 
"command environment" which must be active in order for a command to be 
accepted. For CMS users, the two basic command environments are the CP 
command environment and the CMS command environment. By default, CP 
commands are acceptable input in the CMS command environment; if you 
enter a CP command, it is executed by CP, but control returns to the CMS 
environment. 



The CMS Environment 

The CMS command language allows you to create, modify, debug, and, in 
general, manipulate a system of files. 

The OS/VS Assembler and many OS/VS and DOS/VS language processors can 
be executed under CMS. For example, the OS VS BASIC, FORTRAN IV, COBOL 
and PL/I compilers, as well as the DOS PL/I and COBOL compilers, can 
execute under CMS. You can find a complete list of language processors 
that can be executed under CMS in the VM/370: Introduction. CMS invokes 
the assembler and the compilers when you issue the appropriate CMS 
commands. The ASSEMBLE command is described in this manual; the 
supported compiler commands are described in the appropriate Program 
Product manuals. 
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CMS commands allow you to read cards from a virtual card reader, 

punch cards to a virtual card punch, and print records on a virtual 

printer. Many commands are provided to help you manipulate your virtual 
disks and files. 

The EDIT command places your virtual machine in the EDIT subcommand 
environment. In this environment you can use the CMS Editor to create 
and modify files. In the EDIT subcommand environment, you can place 
your virtual machine in either of two modes, edit mode or input mode. 
Edit mode lets you modify a file; input mode lets you create or add to a 
file. The subcommands available to you in the EDIT subcommand 
environment are described in "Section 3. EDIT Subcommands and Macros." 

The EXEC command executes CMS command procedures, called EXEC files. 
You can create EXEC procedures consisting of CMS and CP commands and 
EXEC control statements. The EXEC facility also has a symbolic 
capability; by manipulating variable symbols within an EXEC file, you 
can control the execution of the procedure. These procedures are 
usually created in the edit environment. The EXEC control statements, 
variable symbols, and built-in functions are described in "Section 5. 
EXEC Control Statements." 

The DEBUG command places your virtual machine in the DEBUG subcommand 
environment. In this environment you can issue commands to display 
registers and storage, specify breakpoints (address instruction stops) , 
display the contents of control words, and so on. The DEBUG subcommands 
are described in "Section 4. DEBUG Subcommands." 

| A special set of CMS commands becomes available to you when you issue 
| the command 

| set dos on 

| These commands, called CMS/DOS commands, simulate various functions of 

| the Disk Operating System (DOS) in your CMS virtual machine. When the 

| CMS/DOS environment is active, the CMS/DOS commands are an integral part 

| of the CMS command language; they are listed alphabetically among the 

I other CMS commands in "Section 2. CMS Commands." 



Entering CMS Commands 

A CMS command consists of a command name, usually followed by one or 
more positional operands and, in many cases, by an option list. CMS 
commands, and EDIT and DEBUG subcommands described in this publication 
are shown in the format: 

I command name | [operands...] [ (options. ..[)] ] 



You must use one or more blanks to separate each entry in the command 
line unless otherwise indicated. For an explanation of the special 
symbols used to describe the command syntax, see "Notational 
Conventions. " 

Hh£ Command Name 

The command name is an alphameric symbol of not more than eight 
characters. In general, the names are based on verbs that describe the 

12 IBM VM/370: CMS Command and Macro Reference 



function you want the system to perform. For example, you may want to 
find out information concerning your CMS files. In this case, you would 
use the LISTFILE command. 

The Command Operands 

The command operands are keywords and/or positional operands of no more 
than eight, and in a few cases, seven alphameric characters each. The 
operands specify the information on which the system operates when it 
performs the command function. 

You must write the operands in the order in which they appear in the 

command formats in "Section 2. CMS Commands," unless otherwise 

specified. When you are using CMS, blanks may optionally be used to 

| separate the last operand from the option list. CMS recognizes a left 

| parenthesis " (" as the beginning of an option list; it does not have to 

| be preceded by a blank. 

lk§ Command Options 

The command options are keywords used to control the execution of the 
command. The command formats in "Section 2. CMS Commands" show all the 
options for each CMS command. 

The option list must be preceded by a left parenthesis; the closing 
parenthesis is not necessary. 

For most commands, if conflicting or duplicate options are entered, 
the last entered is the option in effect for the command. Exceptions to 
this rule are noted where applicable. 

Comments in CMS Command Lines 

If you want to write comments with CMS commands, you enter them 
following the closing parenthesis of the option list. The only 
exception to this rule is the ERASE command, for which comments are not 
allowed. 

You can also enter comments on your console by using the CP * 
command. 



Character Set Usage 

CMS commands may be entered using a combination of characters from six 
different character sets. The contents of each of the character sets is 
shown in Figure 1. 
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Character Set | 

Separator 

National 



Alphabetic 

Numeric 
Alphameric 

Special 



Names 



Blank 



Dollar Sign 
Pound Sign 
At Sign 

Uppercase 
Lowercase 

Numeric 

National 
Alphabetic 

Numeric 



| Symbols 



$ 
* 

a 
a - z 

a — z 
0-9 

$, #, a 
a - z 

a — z 
0-9 

All other 
characters 



Figure 1. Character Sets and Their Contents 



Notationcri Conventions 



The notation used to define the command syntax in this publication is: 



• Truncations and Abbreviations of Commands 

Where truncation of a command name is permitted, the shortest 
acceptable version of the command is represented by uppercase 
letters. (Remember, however, that CMS commands can be entered with 
any combination of uppercase and lowercase letters.) The following 
example shows the format specification for the FILEDEF command. 

Flledef 

This format means that FI, FIL, FILE, FILED, FILEDE, and FILEDEF are 
all valid specifications for this command name. 

Operands and options are specified in the same manner. Where 
truncation is permitted, the shortest acceptable version of the 
operand or option is represented by uppercase letters in the command 
format box. If no minimum truncation is noted, the entire word 
(represented by all uppercase letters) must be entered. 

Abbreviations are shorter forms of command operands, and options. 
Abbreviations for operands and options are shown in the description 
of the individual operands and options that follow the format box. 
For example, the abbreviation for MEMBER in the PRINT command is MEM. 
Only these two forms are valid and no truncations are allowed. The 
format box contains 



MEMBER 



/ name ) 
I * J 



and the description that follows the format box is 



MEMBER 
MEM 



|na.e| 
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• The following symbols are used to define the command format and 
should never be typed when the actual command is entered. 

underscore _ 
braces { } 
brackets [ ] 
ellipsis 

• Uppercase letters and words, and the following symbols, should be 
entered as specified in the format box. 

asterisk * 

comma , 

hyphen 

egual sign = 

parentheses ( ) 

period 

colon : 

• The abbreviations, fn ft and fm, are used to refer to filename, 
filetype, and filemode, respectively. The combination of fn ft [fm] 
are sometimes collectively referred to as file identifier, or 
fileid. 

When a command format box shows the characters, fn ft fm or fileid 
and they are not enclosed by brackets or braces, it indicates that a 
CMS file identifier must be entered. If an asterisk (*) appears 
beneath fn, ft, or fm, it indicates that an asterisk may be coded in 
that position of the fileid. The operand description describes the 
usage of the *. 

• Lowercase letters, words, and symbols that appear in the command 
format box represent variables for which specific information should 
be substituted. For example, "fn ft fm" indicates that file 
identifiers such as "MYFILE EXEC A1" should be entered. 

• Choices are represented in the command format boxes by stacking. 

A 
B 
C 

• An underscore indicates an assumed default option. If an underscored 
choice is selected, it need not be specified when the command is 
entered. 

Example 

The representation 

A 
B 
C 

indicates that either A, B, or C may be selected. However, if B is 
selected, it need not be specified. Or, if none is entered, B is 
assumed. 
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• The use of braces denotes choices, one of which must be selected. 

Example 

The representation 




indicates that you must specify either A, or B, or C. If a list of 
choices is enclosed by neither brackets or braces, it is to be 
treated as if enclosed by braces. 



• The use of brackets denotes choices, one of which may be selected. 



Example : 

The representation 

r t 

I A | 

I B | 

I C | 

L J 

indicates that you may enter A, B, or C, or you may omit the field. 

» An ellipsis indicates that the preceding item or group of items may 
be repeated more than once in succession. 

Example 

The representation 

(options. . .) 

indicates that more than one option may be coded within the 
parentheses. 



CMS COMMAND SEARCH ORDER 

When you enter a command name at the terminal, CMS begins searching for 
the command of that name. Once a match is found, the search stops. The 
search order is: 

1. EXEC file on any currently accessed disk. CMS uses the standard 
search order (A through 6, S, ¥, and Z.) 

2. Valid abbreviation or truncation for an EXEC file on any currently 
accessed disk, according to current SYNONYM file definitions in 
effect. 

3. CMS command that has already been loaded into the transient area. 
The commands that execute in the transient are: 



ACCESS 


FILEDEF 


OPTION 


ASSGN 


GENDIRT 


PRINT 


COMPARE 


GLOBAL 


PUNCH 


DISK 


LISTFILE 


QUERY 


DLBL 


MODMAP 


READCARD 
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GENMOD 


START 


INCLUDE 


STATE 


LOAD 


STATEW 


LOADMOD 





RELEASE SVCTRACE TAPE 

RENAME SYNONYM TYPE 

SET 

4. CMS nucleus resident command. The nucleus-resident CMS commands 
are: 

CP 

DEBUG 
ERASE 
FETCH 

5. Command module on any currently accessed disk. (All the remaining 
CMS commands are disk resident and execute in the user area.) 

6. Valid abbreviation or truncation for nucleus- resident or transient 
area command module. 

7. Valid abbreviation or truncation for disk resident command. 

Figure 2 shows a basic description of the command search order; you 
can find complete details in the VM/370: System Programmer's Guide. 



CMS Command Summary 

Figure 3 contains an alphabetical list of the CMS commands and the 
functions performed by each. Unless otherwise noted, CMS commands are 
described in this manual. The "Code" column in Figure 3 indicates, for 
those commands not described in this manual, the reference source for 
that command: 

Code Meaning 

DOS PP indicates that this command invokes a DOS Program Product, 
available from IBM for a license fee. 

EREP indicates that this command is described in the VM/370: 
ISZ iron mental Recording, Editing, and Printing (EREP) 
P r ogra m . 

IPCS indicates that this command is a part of the Interactive 
Problem Control System (IPCS) and is described in the VM/370: 
Interactive Problem Control System (IPCS) User's Guide. 

Op Gd indicates that this command is described in the VM/370: 
OEetator's Guide. 

OS PP indicates that this command invokes an OS Program Product, 
available from IBM for a license fee. 

SCRIPT indicates that this command invokes a text processor that is 
an IBM Installed User Program, available from IBM for a 
license fee. 

SPG indicates that this command is described in the VM/370: System 
PE22Eammer's Guide. 

SYSGEN indicates that this command is described in the VM/370: 
Planning S&d System Generation Guide. 

Note: If a CMS command is described in this manual, but is also repeated 
in other VM/370 publications, the chart does not refer to those other 
publications. 
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EXECUTE 
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AND RETURN 
CONTROL TO 
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CMS 
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SEARC 
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NAME TO THE 
FULL REAL 
NAME, EXECUTE 
IT, AND RETURN 
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CMS 
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EXPAND THE 
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IT, AND RETURN 
CONTROL TO CMS. 




^YES ^ 














CI 
SEAI 
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S^ IS THE \s 
<Q NAME A 
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EXECUTE THE 
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CMS. 
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/^ ISSUE 
( AN ERROR 
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Figure 2. How CMS Searches for the Command to Execute 
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Any of the commands listed in Figure 3 may be entered when: you are 
running CHS in your virtual machine, the terminal is idle, and the 
virtual machine is receptive for input. If however, CHS is processing a 
previously entered command and your typewriter terminal keyboard is 
locked, you must signal your virtual machine via an attention 
interrupt. The system acknowledges the interrupt by unlocking the 
keyboard. Now you can enter commands. 

If your terminal is a display device, there is no problem of entering 

commands while the virtual machine is busy as its keyboard remains 

unlocked for additional command input. Note that in these circumstances 

the command you enter is stacked and is not executed until the command 

| that is currently executing completes. If more commands are entered 

| than can be handled by CP, a NOT ACCEPTED message is displayed at the 

I display terminal. 

In addition to the commands listed in Figure 3, there are seven 
commands called Immediate commands which are handled in a different 
manner from the others. They may be entered while another command is 
executing, by pressing the Attention key (or its equivalent) and they 
are executed immediately. The Immediate commands are: 

HB - Halt batch execution 

HO - Halt tracing 

HT - Halt typing 

HX - Halt execution 

HO - Resume tracing 

RT - Resume typing 

SO - Suspend tracing 
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Command 
ACCESS 

AMSERV 

ASM3705 

ASSEMBLE 

ASSGN 

CMSBATCH 
COBOL 

COMPARE 

CONVERT 

COPYFILE 

CP 

CPEREP 

DDR 

DEBUG 
DIRECT 

DISK 

DLBL 

DOSGEN 
DOSLIB 

DOSLKED 

DOSPLI 
DSEBV 



I Code | Usage 

Identify direct access space to a CMS virtual 
machine, create extensions and relate the disk 
space to a logical directory. 

Invoke Access Method Services utility functions to 
create, alter, list, copy, delete, import, or 
export VSAM catalogs and data sets* 

SYSGEN | Assemble 3704/3705 source code. 

Assemble Assembler Language source code. 

Assign or unassign a CMS/DOS system or programmer 
logical unit for a virtual I/O device. 

Invoke the CMS Batch Facility. 

OS PP | Compile OS ANS Version 4 or OS/VS COBOL source 
code. 

Compare records in CMS disk files. 

OS PP | Convert free form FORTRAN statements to fixed form. 

Copy CMS disk files according to specifications. 

Enter CP commands from the CMS environment. 

Edit and print error information which was recorded 
by VM/370 error recording routines. 

Perform backup, restore, and copy operations for 
disks. 

Enter DEBUG subcommand environment, debug mode. 

Set up VM/370 directory entries. 



EREP 



Op Gd, 
SYSGEN 



Op Gd, 
SYSGEN 



Perform disk-to-card and card— to-disk operations 
for CMS files. 

Define a DOS filename or VSAM ddname and relate 
that name to a disk file. 

SYSGEN JLoad and save the CMSDOS shared segment. 

Delete, compact, or list information about the 
phases of a CMS/DOS phase library. 

Link— edit CMS text decks or object modules from a 
DOS/VS relocatable library and place them in 
executable form in a CMS/DOS phase library. 

DOS PP | Compile DOS PL/I source code under CMS/DOS. 

Display information contained in the DOS/VS core 
image, relocatable, source, procedure, and 
transient directories. 



Figure 3. CMS Command Summary (Part 1 of 4) 
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Command |Code | 



Usage 



DUMPSCAN 
EDIT 

ERASE 
ESERV 

EXEC 



FCOBOL 


DOS PP 


FETCH 




FILEDEF 




FORMAT 




FORTGI 


OS PP 


FORTHX 


OS PP 


GEN3705 


SYSGEN 


GENDIRT 




GENMOD 




GLOBAL 





GOFORT 

INCLUDE 

LISTDS 

LISTFILE 
LISTIO 

LKED 
LOAD 
LOADMOD 
MACLIB 
Figure 3. 



IPCS 



OS PP 



SYSGEN 



Provide interactive analysis of CP abend dumps. 

Invoke the CMS Editor to create or modify a disk 
file. 

Delete CMS disk files. 

Display, punch or print an edited (compressed) 
macro from a DOS/VS source statement library 
(E sublibrary) . 

Execute special procedures made up of frequently 
used sequences of commands. 

Compile DOS/VS COBOL source code under CMS/DOS. 

Fetch a CMS/DOS or DOS/VS executable phase. 

Define an OS ddname and relate that ddname to any 
device supported by CMS. 

Prepare disks in CMS 800-byte block format. 

Compile FORTRAN source code using the G1 compiler. 

Compile FORTRAN source code using the H— extended 
compiler. 

Generate an EXEC file that assembles and link-edits 
the 3704/3705 control program. 

Fill in auxiliary module directories. 

Generate non-relocatable CMS files (MODULE files) . 

Identify specific CMS libraries to be searched for 
macros, copy files, missing subroutines, or DOS 
executable phases. 

Compile FORTRAN source code and execute the program 
using the FORTRAN Code and Go compiler. 

Bring additional TEXT files into storage and 
establish linkages. 

List information about data sets and space 
allocation on OS, DOS, and VSAM disks. 

List information about CMS disk files. 

Display information concerning CMS/DOS system and 
programmer logical units. 



Link— edit the 3704/3705 control program. 
Bring TEXT files into storage for execution. 
Bring a single MODULE file into storage. 
Create or modify CMS macro libraries. 
CMS Command Summary (Part 2 of 4) 
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Command 


|Code 


" - " T 

| Usage | 


MODMAP 




IDisplay the load map of a MODULE file. | 


MOVEFILE 




|Move data from one device to another device of the | 
same or a different type. | 


NCPDUMP 


| Op Gd , 
ISYSGEN, 
SPG 


Process CP spool reader files created by 3704/3705 | 
| dumping operations. | 


OPTION 




Change the DOS COBOL compiler (FCOBOL) options that| 
1 are in effect for the current terminal session. | 


PLIC 


OS pp 


Compile and execute PL/I source code using the | 
PL/I Checkout Compiler. | 


PLICR 


OS pp 


Execute the PL/I object code generated by the OS | 
PL/I Checkout Compiler. | 


PLIOPT 


OS PP 


Compile PL/I source code using the OS PL/I | 
Optimizing Compiler. | 


PRB 


IPCS 


Update IPCS problem status. | 


PRINT 




Spool a specified CMS file to the virtual printer. | 


PROB 


IPCS 


Enter a problem report in IPCS. | 


PSERV 




Copy a procedure from the DOS/VS procedure library | 
onto a CMS disk, display the procedure at the | 
terminal, or spool the procedure to the virtual | 
punch or printer. | 


PUNCH 




Spool a copy of a CMS file to the virtual punch. | 


QUERY 




Reguest information about a CMS virtual machine. | 


READCARD 




Read data from spooled card input device. | 


RELEASE 




Make a disk and its directory inaccessible to a CMS| 
virtual machine. | 


RENAME 




Change the name of a CMS file or files. | 


RSERV 




Copy a DOS/VS relocatable module onto a CMS disk, | 
display it at the terminal, or spool a copy to | 
the virtual punch or printer. | 


RUN 




Initiate series of functions to be performed on a | 
source, MODULE, TEXT, or EXEC file. | 


SAVENCP | 


SYSGEN, 

SPG | 


Read 3704/3705 control program load into virtual | 
storage and save an image on a CP— owned disk. | 


SCRIPT | 


SCRIPT | 


Format and print documents according to embedded | 
SCRIPT control words in the document file. | 


SET | 




Establish, set, or reset CMS virtual machine | 
characteristics. | 



Figure 3. CMS Command Summary (Part 3 of 4) 
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Command 
SET KEY 

SORT 

SSERV 

START 

STAT 

STATE 

STATEH 

SVCTRACE 

SYNONYM 

TAPE 

TAPEMAC 

TAPPDS 

TESTCOB 

TESTPORT 

TXTLIB 

TYPE 

UPDATE 

VMFDUMP 

VMFLOAD 

V SAM GEN 

VSAPL 

VSBASIC 

VSBDTIL 

ZAP 



| Code 
SPG 



IPCS 



OS PP 
OS PP 



Op Gd 
IPCS 

SYSGEN 

SYSGEN 

OS PP 

OS PP 

OS PP 

Op Gd, 

SYSGEN, 

SPG 



I Usage 

Assign storage protect keys to storage assigned to 
named systems. 

Arrange a specified file in ascending order 
according to sort fields in the data records. 

Copy a DOS/VS source statement book onto a CMS 
disk, display it at the terminal, or spool a copy 
to the virtual punch or printer. 

Begin execution of programs previously loaded (OS 
and CMS) or fetched (CMS/DOS) . 

Display the status of reported system problems. 

Verify the existence of a CMS disk file. 

Verify a file on a read/write CMS disk. 

Record information about supervisor calls. 

Invoke a table containing synonyms you have created 
for CMS and user-written commands. 

Perform tape— to— disk and disk— to-tape operations 
for CMS files, and position tapes. 

Create CMS MACLIB libraries directly from an 
IEHMOVE— created partitioned data set on tape. 

Load OS partitioned data set (PDS) files or card 
image files from tape to disk. 

Invoke the OS COBOL Interactive Debug Program. 

Invoke the FORTRAN Interactive Debug Program. 

Generate and modify text libraries. 

Display all or part of a CMS file at the terminal. 

Make changes in a program source file as defined 
by control cards in a control file. 

Format and print system abend dumps; under IPCS, 
create a problem report. 

Generate a new CP, CMS or RSCS module. 

Load and save the VSAM shared segment. 

Invoke the VS APL interface. 

Compile and execute VS BASIC programs under CMS. 

Convert BASIC 1.2 data files to VS BASIC format. 

Modify or dump LOADLIB, TXTLIB, or MODULE files. 



Figure 3. CMS Command Summary (Part 4 of 4) 
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Section 2. CMS Commands 



This section contains reference information for the CHS commands used by 
general users. Each command description indicates the format, operands 
and options, and error messages and return codes issued by the command. 
Usage notes are provided, where applicable. 

The formats of the DEBUG, EDIT, and EXEC commands are also listed; 
for details on the EDIT or DEBUG subcommands or EXEC control statements, 
see: 

• "Section 3. EDIT Subcommands and Macros" 

• "Section 4. DEBUG Subcommands" 

• "Section 5. EXEC Control Statements" 

For more detailed usage information on CMS commands, see the VM/370: CMS 
User's Guide. 
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ACCESS 



ACCESS 



Use the ACCESS command to identify a disk to CMS, establish a filemode 
letter for the files on the disk, and set up a file directory in 
storage. The specifications of the ACCESS command determine the entries 
in the user file directory. The format of the ACCESS command is: 

I I r 

Access | | cuu mode[/ext [fn [ft [fm]]]] [ (NOPROF [)]] 

121 k * * * 

cuu mode (ERASE [) ] 
(NODISK [) ] 



where: 



cuu 



makes the disk at the specified virtual device address 
available. The default value is 191. 



Valid addresses are 001 through 5FF for a virtual machine in 
basic control mode, and 001 through FFF for a virtual machine 
in extended control mode. 

mode assigns a 1-character filemode letter to all files on the disk 
being accessed. This field must be specified if cuu is 
specified. The default value is A. 

ext indicates the mode of the parent disk. Files on the disk 
being accessed (cuu) are logically associated with files on 
the parent disk; the disk at cuu is considered a read— only 
extension. A blank must not precede or follow the diagonal 
(/). 

fn [ft [fm]] 

defines a subset of the files on the specified disk. Only the 
specified files are included in the user file directory and 
only those files can be read. An asterisk coded in any of 
these fields indicates all filenames, filetypes, or filemode 
numbers (except 0) are to be included. (See Usage Notes 3 and 



Ojgt ion s : 
NOPROF 



ERASE 



NODISK 



suppresses execution of a PROFILE EXEC file. This option 
is valid only if the ACCESS command is the first command 
entered after you IPL CMS. On subsequent ACCESS 
commands, the NOPROF option is ignored. 

specifies that you want to erase all of the files on the 
specified disk. This option is only valid for read/write 
disks. (See Usage Note 6.) 

lets you gain access to the CMS operating system with no 
disks accessed except the system disk (S-disk) and its 
extensions. This option is only valid if the ACCESS 
command is the first command you enter after you IPL 
CMS. 
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ACCESS 

H§§35 Notes 

1. If you have disk addresses 190, 191 , 192, and 19E defined in the 
VM/370 directory, or if they are defined before you IPL CMS, these 
disks are accessed as the S- , A- , D-, and Y-disks respectively. 
You must issue explicit ACCESS commands to access any other disks 
you wish to use following an IPL of the CMS system. Ordinarily, 
you have access only to files with a filemode number of 2 on the 
system disk. 

2. Each CMS disk has associated with it a master file directory, which 
contains an entry for every CMS file on the disk. The user file 
directory created in storage by the ACCESS command contains entries 
for only those files that you can reference. 

| You should issue an ACCESS command every time you link to a new 
| minidisk with the CP LINK command, to obtain the appropriate file 
| directory. 

3. The filename, filetype, and filemode fields can only be specified 
for disks which are accessed as read-only extensions. For example, 

access 195 b/a * assemble 

gives you read-only access to all the files with a filetype of 
ASSEMBLE on the disk at virtual address 195. The command 

access 190 z/a * * z1 

gives you access to all files on the system disk (190) that have a 
filemode number of 1. 

When you access any disk in read-only status, files with a filemode 
number of are not accessed. 

4. You can also identify a set of files on a disk by referring to a 
filename or filetype prefix. For example, 

access 192 c/a abc* 

accesses only those files in the disk at virtual address 192 whose 
filenames begin with the characters ABC. The command line 

access 192 c/a * a* c2 

gives you access to all files whose filetypes begin with an A and 
which have a filemode number of 2. 

5. You can force a read/write disk into read-only status by accessing 
it as an extension of another disk or of itself, for example, 

access 191 a/a 

forces your A-disk into read-only status. 

6. If you enter the ERASE option by mistake you can recover from the 
error as long as you have not yet written any new files onto the 
disk. (That is, you have not yet caused CMS to rewrite the master 
file directory.) Reissue the ACCESS command without the ERASE 
option. 

7. You should never attempt to access a disk in read/write status if 
another user already has it in read/write status; the results are 
unpredictable. 
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ACCESSING OS AND DOS DISKS: 

1. You cannot specify filename, filetype and filemode when you access 
OS or DOS disks „ nor can you specify any options. 

2. When you are using OS or DOS disks, you must have a read/write CMS 
A-disk available if you are going to use the LOAD command with the 
MAP option. (MAP is a default option.) 

H^sponses 

r i 

DMSACC723I mode (cuu} ( R/0 ) |-0S | 

(R/W/ | -DOS | 

L J 

If the specified disk is a CMS disk, this message is displayed if 
the disk is read-only. If the disk is in OS or DOS format, the 
message indicates the format, as well as whether it is a read/write 
or read-only disk. 

DMSACC724I cuul REPLACES mode (CUU2) 

Before execution of the command, the disk represented by cuu2 was 
the "mode" disk. The disk, cuul, is now assigned that filemode 
letter. This message is followed by message DMSACC726I. 

r t 

DMSACC725I cuu ALSO == 'mode 1 |-0S | DISK 

|-DOS| 

L J 

The disk specified by cuu is the mode disk and an ACCESS command 
was issued to assign it another filemode letter. 

DMSACC726I 'cuu mode* RELEASED 

The disk being accessed at virtual address cuu as a read/write disk 
is already accessed at a different mode. It is released from that 
mode. Or, a disk currently accessed at mode is being replaced. 



Other Messages and Return Codes 

DMSACC002E FILE 'DMSROS TEXT 1 NOT FOUND RC=28 

DMSACC003E INVALID OPTION •option' RC=24 

DMSACC017E INVALID DEVICE ADDRESS «cuu« RC=24 

DMSACC048E INVALID MODE 'mode' RC=24 

DMSACC059E 'cuu' ALREADY ACCESSED AS READ/WRITE 'mode* DISK RC=36 

DMSACC060E FILE (S) • f n [ft [fm]]' NOT FOUND. DISK 'mode (cuu) 1 WILL NOT 

BE ACCESSED RC=28 
DMSACC070E INVALID PARAMETER 'parameter* RC=24 
DMSACC112S DISK 'mode(cuu)' DEVICE ERROR RC=100 
DMSACC113S mode (CUU) NOT ATTACHED RC=100 

DMSACC230W OS DISK - FILEID AND/OR OPTIONS SPECIFIED ARE IGNORED RC=4 
DMSACC240S ERROR LOADING READ OS ROUTINE 'DMSROS TEXT' 
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AMSERV 

Use the AMSERV command to invoke Access Method Services to: 

• Define VSAM catalogs, data spaces, or clusters 

• Alter, list, copy, delete, export or import VSAM catalogs and data 
sets 

The format of the AMSERV command is: 



r n 
fn1 |fn2| [ (options. ..[) ]] 

IfnJI 

L J o£^i on s : 
[PRINT] 



r i r i 

|TAPIN M8n )| ITAPOOT M8n 1| 

| (TAPn/l | iTAPn/l 

L J L J 



where : 

fn1 specifies the filename of a CMS file with a filetype of AMSERV that 
contains the Access Method Services control statements to be 
executed. CMS searches all of your accessed disks, using the 
standard search order, to locate the file. 

fn2 specifies the filename of the CMS file that is to contain the 
Access Method Services listing; the filetype is always LISTING. If 
fn2 is not specified, the LISTING file will have the same name as 
the AMSERV input file (fn1) . 

The LISTING file is written to the first read/write disk in the 
standard search order, usually your A-disk. If a LISTING file with 
the same name already exists, it is replaced. 

Options : 

PRINT spools the output listing to the virtual printer, instead of 
writing it to disk. If PRINT is specified, fn2 cannot be 
specified. 



TAPIN 



M8n \ 

iTAPnj 



specifies that tape input is on the tape drive at the addresss 
indicated by 18n or TAPn. n may be 1, 2, 3, or 4, indicating 
virtual addresses 181 through 184, respectively. 



TAPOUT 



M8n ) 
I TAPn / 



specifies that tape output should be written to the tape drive 

at the address indicated by 18n or TAPn. n may be 1, 2, 3, or 

4, indicating virtual addresses 181 through 184, 
respectively. 

Note: If both TAPIN and TAPOUT are specified, their virtual device 
addresses must be different. 
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I Usajge Notes 

1. To create a job stream for Access Method Services, you can use the 
CMS Editor to create a file with the filetype of AMSERV. The 
editor automatically sets input margins at columns 2 and 72. 

2. Refer to the DOS^VS Access Method Services User^s Guide, for a 
description of Access Method Services control statements format and 
syntax. Restrictions placed on VSAM usage in CMS are listed in this 
publication, in "Appendix B: DOS/VS Access Method Services and VSAM 
Functions Not Supported in CMS" and "Appendix C: OS/VS Access 
Method Services and VSAM Functions Not Supported in CMS." 

3. You must use the DLBL command to identify the master catalog and 
all disk input and output files for Access Method Services; the 
ddname operand of the DLBL command corresponds to the dname 
parameter following a FILE, INFILE, or OUTFILE keyword in an Access 
Method Services statement. 

4. When you use tape input and/or output with the AMSERV command, you 
are prompted to enter the ddnames; a maximum of 16 ddnames are 
allowed for either input and output. The ddnames can each have 
maximum of seven characters, and must be separated by blanks. 

Since only one tape can be attached at a time for either input or 

output while using AMSERV, if you you enter more than one tape 

ddname, the tape files must be the in sequence they are used in the 
input stream. 

4d^iii2S§I Notes for CMS/DOS Users: 

1. You must assign a logical unit to be associated with each ddname 
named in a DLBL command when you use the AMSERV command in the 
CMS/DOS environment. 

2. CMS internally issues an ASSGN command for SYSIPT, and locates the 
source file; therefore you do not need to assign it. If you use 
the TAPIN or TAPOUT options, CMS also issues ASSGN commands for the 
tape drives (assigning logical units SYSOOU and SYS005) . 

Any other assignments and DLBL definitions that are in effect when 
you invoke the AMSERV command are saved and restored when the 
command completes executing. 

Responses 

The CMS Ready message indicates that Access Method Services has 
completed processing. If Access Method Services completed with a nonzero 
return code, the return code is shown in the Ready message. You should 
examine the LISTING file created by AMSERV to determine the results of 
Access Method Services processing,. 

The publication DOS^VS Messages, Order No. GC33-5379, lists and 
explains all of the messages generated by Access Method Services 
together with the associated reason codes. 

DMSAMS367R ENTER TAPE { INPUT |OUTPUT } DDNAMES: 

This message prompts you to enter the ddnames associated with the 
tape files. 
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| DMSAMS722I FILE «fn2 LISTING fm» WILL HOLD AMSERV OUTPUT 

| This message is displayed when you enter a £n2 operand or when the 
| listing is not being written on your A-disk; it tells you the file 
| identifier of the output listing. 

I 0£!li~£ Messages and Return Codes 

| DMSAMS001E NO FILENAME SPECIFIED RC=24 

| DMSAMS002E FILE »fn1 AMSERV 1 NOT FOUND RC=28 

| DMSAMS003E INVALID OPTION 'option* RC=24 

| DMSAMS006E NO READ/WRITE DISK ACCESSED FOR »fn2 LISTING' RC=36 

| DMSAMS007E FILE »fn1 AMSERV fm' NOT FIXED, 80-CHAR. RECORDS RC=32 

| DMSAMS065E 'option* OPTION SPECIFIED TWICE RC=24 

| DMSAMS066E 'option' AND 'option' ARE CONFLICTING OPTIONS RC=24 

| DMSAMS070E INVALID PARAMETER 'parameter' RC=24 

| DMSAMS109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

| DMSAMS113E { TAPIN | TAPOUT } (addr) NOT ATTACHED RC=100 

| DMSAMS136S UNABLE TO LOAD 'IDCAMS' RC=104 

| DMSAMS228E NO DDNAME ENTERED RC=24 

| DMSSTT062E INVALID CHARACTER 'char' IN FILEID {'fn1 AMSERV |'fn2 

I LISTING' } RC=20 
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ASSEMBLE 



Use the ASSEMBLE command to invoke the assembler to assemble a file 
containing source statements. Assembler processing and output is 
controlled by the options selected. The format of the ASSEMBLE command 
is: 



Assemble 



fn [ (options. . .[) ]] 
listing control options: 



I lifi GI C | 
INOALOGICI 

L J 



r i 
I BSD | 

|NOlSD| 

L J 



r t r t 

IFLAG (nnn) | ILINECOUN (nn) | 

I FLAG (0) | ILINECOUN (55) | 

L J U ~" J 



r n r i r i r i r i 

ILIST | IMCALL | | MLOGIC | |RLD | |LIBMAC | 

| NOLI ST | |NOMCALL| | NOMLOG IC | |N0RLD| |NOLIBMAC| 

L J L J L ~ J L J l"" ~J 



r t r t 

IXREF (FULL) | | PRINT | 

IXREF (SHORT) | |NOPRINT| 

INOXREF | | DISK | 

L J L J 



2J3i£]li c ont r ol options: 

r t r t r i 
| DECK | | OBJECT | | TEST | 
|N0DECK| jNOOBJECTI |NOTEST| 

i. J L J L ~ ~J 

SjfSTERM options: 

r t r t r t 

I NUMBER | I STMT | | TERMINAL | 
INONUM | |NOSTMT| | NOTERM** | 

L J L J L J 

other assembler options: 

r t r t r n 

| ALIGN | IBUFSIZE (MIN) | | RENT | 
|N0ALIGN| IBUFSIZE (STD) | |N0RENT| 

L J L J L J 



r t 

IYFLAG | 

I » Qllhh G I 

L~ ~ J 



r t 

ISYSPARM (string) | 

ISYSPARM () | 

ISYSPARM (?) | 

L J 



—J 



where : 
fn 



is the filename of the source file to be assembled and/or the 
filename of assembler output files. The file must have 
fixed-length, 80-character records. By default, the assembler 
expects a CMS file with a filetype of ASSEMBLE. 
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Ifistinci Control Options: The list below describes the assembler 
options you can use to control the assembler listing. The default 
values are underscored. 

ALOGIC lists conditional assembly statements in open code. 

NOALOGIC suppresses the ALOGIC option. 

ESD lists the external symbol dictionary (ESD) . 

NOESD suppresses the printing of the ESD listing. 

FLAG (nnn) does not include diagnostic messages and MNOTE 
FLAG XQ1 messages below severity code nnn in the listing. 
Diagnostic messages can have severity codes of 4, 8, 
12, 16, or 20 (20 is the most severe); and MNOTE 
message severity codes can be between and 255. For 
example, FLAG (8) suppresses diagnostic messages with a 
severity code of 4 and MNOTE messages with severity 
codes of through 7. 

LINECOUN (nn) nn specifies the number of lines to be listed per 
LINECOUN J551 page. 



LIST 
NOLIST 

MCALL 



HOMCALL 
MLOGIC 

NOMLOGIC 

NORLD 
LIBMAC 



NOLIBMAC 
XREF iFULLl 



produces an assembler listing. 

does not produce an assembler listing. This option 
overrides ESD, RLD, and XREF. 

lists the inner macro instructions encountered during 
macro generation following their respective outer macro 
instructions. The assembler assigns statement numbers 
to these instructions. The MCALL option is implied by 
the MLOGIC option; NOMCALL has no effect if MLOGIC is 
specified. 

suppresses the MCALL option. 

lists all statements of a macro definition processed 
during macro generation after the macro instruction. 
The assembler assigns statement numbers to them. 

suppresses the MLOGIC option. 

produces the relocation dictionary (RLD) as part of the 
listing. 

does not print the relocation directory. 

lists the macro definitions read from the macro 
libraries and any assembler statements following the 
logical END statement. The logical END statement is 
the first END statement processed during macro 
generation. It may appear in a macro or in open code; 
it may even be created by substitution. The assembler 
assigns statement numbers to the statements that follow 
the logical END statement. 

suppresses the LIBMAC option. 

includes in the assembler listing a cross-reference 
table of all symbols used in the assembly. This 
includes symbols that are defined but never referenced. 
The assembler listing also contains a cross-reference 
table of literals used in the assembly. 
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XREF (SHORT) includes in the assembler listing a cross-reference 
table of all symbols that are referenced in the 
assembly. Any symbols defined but not referenced are 
not included in the table. The assembler listing 
contains a cross-reference table of literals used in 
the assembly. 



NOXREF 

PRINT 
PR 

NCPRINT 
NOPR 

DISK 
DI 



does not print the cross-reference tables, 
writes the LISTING file to the printer. 

suppresses the printing of the LISTING file. 

places the LISTING file on a virtual disk. 



OiliEHi Control _QP_tions: The output control options are used to 
control the object module output of the assembler. 



DECK 



NODECK 

OBJECT 
OBJ~ 



NOOBJECT 
NOOBJ 

TEST 



NOT EST 



writes the object module on the device specified on the 
FILEDEF statement for PUNCH. If this option is 
specified together with the OJBECT option, the object 
module is written both on the PUNCH and TEXT files. 

suppresses the DECK option. 

writes the object module on the device which is 
specified by the FILEDEF statement for TEXT. If this 
option is specified together with the DECK option, the 
object module is written on the two devices specified 
in the FILEDEF statement for TEXT and PUNCH. 

does not create the object module. 



includes the special source symbol table (SYM cards) in 
the object module. 

Does not produce SYM cards. 



SYSTERM OEtions: The SYSTERM options are used to control the SYSTERM 
file associated with your assembly. 



NUMBER 
NUM 



NONUM 
STMT 

NOSTMT 

TERMINAL 
TERM 



writes the line number field (columns 73-80 of the 
input records) in the SYSTERM listing for statements 
for which diagnostic information is given. This option 
is valid only if TERMINAL is specified. 

suppresses the NUMBER option. 

writes the statement number assigned by the assembler 
in the SYSTERM listing for statements for which 
diagnostic information is given. This option is valid 
only if TERMINAL is specified. 

suppresses the STMT option. 

writes the diagnostic information on the 
SYSTERM data set. The diagnostic information consists 
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NOTERM 



of the diagnosed statement followed by the error 
message issued. 

suppresses the TERMINAL option. 



Other Assembler Options: The following options allow 
various functions and values for the assembler. 



you to specify 



ALIGN aligns all data on the proper boundary in the 

ALGN object module; for example, an F-type constant is 

aligned on a fullword boundary. In addition, the 

assembler checks storage addresses used in machine 

instructions for alignment violations. 

NOALIGN does not align data areas other than those 
NOALGN specified in CCW instructions. The assembler does not 

skip bytes to align constants on proper boundaries. 

Alignment violations in machine instructions are not 

diagnosed. 

BUFSIZE (MIN) uses the minimum buffer sizes (790 bytes) for each of 
the utility data sets (SYSUT1, SYSUT2, and SYSUT3) . 
Storage normally used for buffers is allocated to work 
space. Because more work space is available, more 
complex programs can be assembled in a given virtual 
storage size; but the speed of the assembly is 
substantially reduced. 

BUFSIZE iSTD)_ chooses the buffer size that gives optimum performance. 
The buffer size depends on the amount of virtual 
storage. Of the assembler working storage in excess of 
minimum reguirements, 37% is allocated to the utility 
data set buffers and the rest to macro generation 
dictionaries. 



RENT 

NCRENT 
YFLAG 



checks your program for a possible violation of program 
reenterability. Code that makes your program 
nonreenterable is identified by an error message. 

suppresses the RENT option. 

does not suppress the warning messages that indicate 
that relocatable Y-type address constants have been 
declared. 



NOYFLAG 



SYSPARM 



suppresses the warning messages that indicate 
relocatable Y-type constants have been declared. 



(string) 



(?) 



passes a character value to the system variable symbol, 
SYSPARM. The variable (string) cannot be greater than 
8 characters. If you want to enter a string of more 
than 8 characters, use the SYSPARM (?) format. Mith 
the SYSPARM (?) form, CMS prompts you with the message: 

ENTER SYSPARM: 

You can enter up to 100 characters. You can also enter 
parentheses and embedded blanks from the terminal. 
SYSPARM () enters a null string of characters. 
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fisacje Notes 

1. When you issue the ASSEMBLE command, default FILEDEF commands are 
issued for assembler data sets. You may want to override these 
with explicit FILEDEF commands. The ddnames used by the assembler 
are: 

ASSEMBLE (SYSIN input to the assembler) 

TEXT (SYSLIN output of the assembler) 

LISTING (SYSPRINT output of the assembler) 

PUNCH (SYSPUNCH output of the assembler) 

CMSLIB (SYSLIB input to the assembler) 

The default FILEDEF commands issued by the assembler for these 
ddnames are: 

FILEDEF ASSEMBLE DISK fn ASSEMBLE fm (RECFM FB LRECL 80 BLOCK 800 

FILEDEF TEXT DISK fn TEXT fm 

FILEDEF LISTING DISK fn LISTING fm (RECFM FBA BLOCK 1210 

FILEDEF PUNCH PUNCH 

FILEDEF CMSLIB DISK CMSLIB MACLIB * (RECFM FB LRECL 80 BLOCK 800 

2. If you want to use any CMS macro or copy libaries during an 
assembly, you must issue the GLOBAL command to identify the macro 
libraries before issuing the ASSEMBLE command. For example, 

global maclib cmslib osmacro testlib 

identifies the MACLIB files named CMSLIB, OSMACRO, and TESTLIB. 

3. In order to use OS macro libraries during an assembly, you must 
issue the FILEDEF command for the OS data set using a ddname of 
CMSLIB, and assigning a CMS file identifier; the filetype must be 
MACLIB, and you must use the filename on the GLOBAL command line, 
for example, 

filedef cmslib disk oldtest maclib c dsn oldtest macros 
global maclib oldtest 

assigns the OS data set OLDTEST. MACROS on the disk accessed as mode 
C, a CMS fileid of OLDTEST MACLIB and identifies it as the macro 
library to be used during assembly. 

4. You cannot assemble programs using DOS macros from the DOS/VS 
source statement libraries under CMS/DOS. You should use the 
SSERV, ESERV, and MACLIB commands to create CMS MACLIBs to contain 
DOS macros for assembly under CMS/DOS. See the VM/370: CMS User's 
G lii.4§ f° r examples. 

5. You do not need to make any logical assignments for input or output 
files when you use the assembler under CrIS/DOS. File definitions 
are assigned by default under CMS, as described in Usage Note 1. 

6. Usage information about the VM/370 Assembler Language and assembler 
options can be found in OS/VS and VM/320 Assembler Programmer's 
Guide and OJS/VS, DOS/VS, and VM/3_20 Assembler Language. ~ ~" 

Messages and Return Codes 

For the messages and return codes associated with the ASSEMBLE command, 
see the OS/VS and VM/370 Assembler Programmer's Guide. 
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I ASSGN 



Use the ASSGN command in CMS/DOS to assign or unassign a system or 
programmer logical unit for a virtual I/O device. The format of the 
ASSGN command is: 




SYSxxx 



Reader 
PUnch 
PRinter 
Terminal 

r t 
TAP|n| 

111 

L J 

mode 

IGN 

UA 



[ (options. ..[) ]] 



op.t ion s : 



r t 

IUPCASE i 
|LOWCASE| 

L J 



r t 
|7TRACK| 
|9TRACK| 

L J 



[TRTCH a] 
[DEN den] 



~*-,-~.J 



where : 
SYSxxx 



READER 

PUNCH 
PRINTER 
TERMINAL 
TAP[n] 

mode 
IGN 



specifies the system or programmer logical unit to be assigned 
to a particular physical device. SYS000 through SYS241 are 
valid programmer logical units in CMS/DOS; they may be 
assigned to any valid device. The system logical units you 
may assign, and the devices to which they may be assigned, 
are : 

SYSxxx Valid assignments 

SYSRDR Reader, disk, tape"" 

SYSIPT Reader, disk, tape 

SYSIN Reader, disk, tape 

SYSPCH Punch, disk, tape 

SYSLST Printer, disk, tape 

SYSLOG Terminal, printer 

SYSOUT Tape 

SYSSLB Disk 

SYSRLB Disk 

SYSCLB Disk 

SYSCAT Disk 

is the spooled card reader (card reader I/O must not be 
blocked) . 

is the spooled punch. 

is the spooled printer. 

is your terminal (terminal I/O must not be blocked) . 

is a magnetic tape, n is the symbolic number of the tape 
drive. It is either 1# 2, 3, or 4, representing virtual 
addresses 181, 182, 183, and 184, respectively. If n is 
omitted, TAP1 is assumed. 

specifies the 1-character mode letter of the disk being 
assigned to the logical unit (SYSxxx) . The disk must be 
accessed when the ASSGN command is issued. 

(ignore) specifies that any attempt to read from the specified 
device results in an end-of-file indication; any attempt to 
write to the device is ignored. IGN is not valid when 
associated with SYSRDR, SYSIPT, SYSIN, or SYSCLB. 
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UA 



indicates that the logical unit is to be unassigned. When you 
release a disk for which an assignment is active, it is 
automatically unassigned. 



Opt ion s : 

UPC&SE 

LOWCASE 

7TRACK 
9TRACK 

TRTCH a 



translates all terminal input data to uppercase, 
retains all terminal input data as keyed in. 
is the tape setting. 



refers to the tape recording technigue for 7-track tapes. 
Use the following chart to determine the value of a. 



r - — 
1 a | 
i 


Parity 


| Co 


averter 
off 


Translator 
I off 


— — , 


1 o J 


odd 






1 oc | 


odd 




on 


off 




1 OT | 


odd 




off 


on 




1 E | 


even 




off 


off 




1 ET | 

L 


even 




off 


on 


i 



DEN den is tape density: den can be 200, 556, 800, 1600, or 6250 

bits per inch (bpi) . If 200 or 556 are specified, 7TRACK 

is assumed. If 800, 1600, or 6250 are specified, 9TRACK is 
assumed. (See Usage Note 8.) 



H S .§.S§ Notes 



2. 



When you enter the CMS/DOS environment with the command SET DOS ON, 
SYSLOG is assigned by default to TERMINAL. If you specify the mode 
letter of the DOS/VS system residence on the SET DOS ON command 
line, SYSRES is assigned to that disk mode. 



You cannot assign any of the 
with the ASSGN command: 



following DOS/VS system logical units 



SYSRES 
SYSUSE 



SYSLNK 
SYSREC 



SYSVIS 



3. If you assign the logical unit SYSIN to a virtual device, SYSRDR 
and SYSIPT are also assigned to that device. If you make a logical 
assignment for SYSOUT, both SYSLST and SYSPCH are assigned. 

4. To obtain a list of current assignments, use the LISTIO command. 

5. To cancel all current assignments (that is, to unassign them) , you 
can enter, in succession, the commands 

set dos off 

set dos on [mode] 

6. If you want to access DOS/VS private libraries, you must assign the 
logical units SYSSLB (source statement library) , SYSRLB 

(relocatable library) , and SYSCLB (core image library) , and you 
must issue the DLBL command to establish a file definition. 
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| 7. An assignment to disk (mode) should be accompanied by a DLBL 

| command that provides the disk file identification. 

| You cannot make an assignment to a 3350 disk in native mode. 

| 8. If no tape options are specified on the command line, the default 

I for a seven-track tape is 800 bpi, data converter off, translator 

I off, and odd parity. If the tape is 9-track, the density defaults 

| to the density of the tape drive. 1600 bpi is the reset condition 

| for 9-track dual density tapes. If the tape drive is phase 

| encoded, density defaults to the density of the tape. If the tape 

| drive is NRZI, the reset condition is 800 bpi. 

I I*6§EP.!lses 

| None. 

I Messages and Return Codes 

| DMSASN003E INVALID OPTION 'option 1 RC=24 

| DMSASN027E INVALID DEVICE 'device* RC=24 

| DMSASN028E NO LOGICAL UNIT SPECIFIED RC=2U 

| DMSASN029E INVALID PARAMETER 'parameter* IN THE OPTION 'option' 

| FIELD RC=24 

| DMSASN035E INVALID TAPE MODE RC=24 

| DMSASN050E PARAMETER MISSING AFTER SYSXXX RC=24 

| DMSASN065E 'option' OPTION SPECIFIED TWICE RC=24 

| DMSASN066E 'option' AND 'option' ARE CONFLICTING OPTIONS RC=24 

| DMSASN069E DISK 'mode' NOT ACCESSED RC=36 

| DMSASN070E INVALID PARAMETER 'parameter' RC=24 

| DMSASN087E INVALID ASSIGNMENT of 'SYSXXX* TO DEVICE 'device' RC=2U 

| DMSASN090E INVALID DEVICE CLASS • deviceclass' FOR 'device' RC=36 

| DMSASN099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

| DMSASN113S '{TAPn|mode|READER|PUNCH|PRINTER} (cuu) • NOT ATTACHED RC-100 

| DMSASN366E NO CMS/DOS SUPPORT FOR NATIVE 3350 DISK RC=36 
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The system operator uses the CMSBATCH command to invoke the CMS Batch 
Facility. Instead of compiling or executing a program interactively, 
you can transfer a job to an active CMS batch virtual machine to free up 
your terminal for other work. The format of the CMSBATCH command is: 



| | CMSBATCH 

L 



J 



U§a_3e. Notes 

1. The CMSBATCH command may be invoked immediately after an IPL of the 
CMS system. Alternatively, BATCH may be specified following the 
PARM operand on the IPL command line. 

2. You should not issue the CMSBATCH command if you use a virtual disk 
at address 195; the CMS batch virtual machine erases all files on 
the disk at address 195. 

3. For a description of how to send jobs to the CMS batch virtual 
machine, see the VM/370: CMS User^s Guide. For an explanation of 
setting up a batch virtual machine see the VM/370: Operator's 
Guide. 



IE£2I H§-ssa<jes and Return Codes 



DMSBTB100E NO BATCH PROCESSOR AVAILABLE RC=40 

DMSBTB101E BATCH NOT LOADED RC= 88 

DMSBTP105E NO JOB CARD PROVIDED RC=None 

DMSBTP106E JOB CARD FORMAT INVALID RC=None 

DMSBTP107E CP/CMS COMMAND •command, (device) • NOT ALLOWED RC=88 

DMSBTP108E /SET CARD FORMAT INVALID RC=None 

DMSBTP109E { CPU | PRINTER| PUNCH } LIMIT EXCEEDED RC=None 
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Use the COMPARE command to compare two CMS disk files of fixed- or 
variable— length format on a record— for— record basis and to display 
dissimilar records at the terminal. The format of the COMPARE command 
is: 



i — 
I 

I COMpare 

I 
I 



fileidl fileid2 [ (COL mm-|nn | [) ]] 

1 lliecll 

L J 



where: 



fileid 



is the file identifier of a file to be 
identifiers (filename, filetype, and 
specified for each fileid. 



Options : 
(COL mm-nn) 



compared. All three 
filemode) must be 



defines specific columns to be compared. The 
comparison begins at position mm of each record in both 
files. The comparison proceeds up to and including 
column nn. If nn is not specified, the default ending 
position is the last character of each record (the 
logical record length) . The "-" is required and may 
not be preceded or followed by a blank. 



Usage Notes 

1. To find out whether two files are identical, enter both file 
identifications, as follows: 

compare testl assemble a testl assemble b 

Any records that do not match are displayed at the terminal. 

2. To stop the display of dissimilar records use the CMS Immediate 
command HT. 

3. If a file does not exist on a specified disk, that disk's read-only 
extensions are also searched. The complete fileids of the files 
being compared are displayed in message DMSCMP179I. 



Responses 

| DMSCMP179I COMPARING • f n ft fm» WITH • f n ft fm» 

This message identifies the files being compared. If the files 

compare (on the columns indicated) , this message is followed by the 

CMS Ready message. If any records do not match, the records are 
displayed. When all dissimilar records have been displayed the 
message DMSCMP209W is issued. 
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O^hei Messages and Return Codes 

DMSCMP002E FILE • f n ft fm 1 NOT FOUND RC=28 

DMSCMP003E INVALID OPTION 'option' RC=24 

DMSCMP005E NO COLUMN SPECIFIED RC=24 

DMSCMP009E COLUMN »col« EXCEEDS RECORD LENGTH RC=24 

DMSCMP010E PREMATURE EOF ON FILE • f n ft fm« RC=U0 

DMSCMP011E CONFLICTING FILE FORMATS RC=32 

DMSCMP019E IDENTICAL FILEIDS RC=24 

DMSCMP029E INVALID PARAMETER •parameter 1 IN THE OPTION 'COL 1 FIELD 

RC=24 
DMSCMP054E INCOMPLETE FILEID SPECIFIED RC=24 
DMSCMP062E INVALID * IN FILEID RC=20 

DMSCMP104S ERROR 'nn 1 READING FILE • f n ft f m • FROM DISK RC=100 
DMSCMP209W FILES DO NOT COMPARE RC=4 
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Use the COPYFILE command to copy and/or modify CMS disk files. The 
manner in which the file identifiers are entered determines whether one 
output file is created (single output mode) or multiple files are 
created (multiple output mode) . The format of the COPYFILE command is: 




fileidil [f ileidi2. . . ] [fileido] [ (options. ..[) ]] 

o£t i on s : 

r i r t r ir i 

| Type | I NEE Pate | |NEWFile| |PRoJ9£t | 
INOTyjaej |OLDDate| |REPlace| |NOPRompt| 

L~JL JL J L J 

r i r t r n 

IFRom recno | |FOR numrec | |SPecs | 
IFRLabel xxxxxxxxj |TOLabel xxxxxxxxj INOSPecsj 

L J L J L~ ~ J 

r t r i r t 

|OVly | |RECfm (F)| [ LRecl nnnnn ] | TRUnc | 
|APpend| | (v/| |NOTRunc| 

L J L J L "" J 

r i r i r n 

IPAck | | Fill c | [EBcdic] |UPcase | 

|UNPack| | Fill hh| |LOwcase| 

L J IZIil i* 1 [TRAns] •- J 

L J 



where : 
fileidil 



fileidi2 



fileido 



is the first (or only) input file. Each file identifier 
(filename, filetype and filemode) must be specified either 
by indicating the specific identifier or by coding an 
asterisk. However, all three file identifiers of fileidil 
cannot be specified by asterisks. 



is one or more additional inpu 
(filename, filetype, and file 
single output mode, any of th 
may be specified either 
identifier or by coding an a 
file identifiers of fileid 
asterisks. In multiple outp 
invalid file identifier. An e 
any of the file identifiers, i 
as the corresponding identifie 



t files. Each file identifier 
mode) must be specified. In 
e three input file identifiers 
by indicating the specific 
sterisk. However, all three 
i2 cannot be specified by 
ut mode, an asterisk is an 
qual sign (=) may be coded for 
ndicating that it is the same 
r in fileidil. 



is the output file (s) to be created. Each file identifier 
(filename, filetype and filemode) must be specified. To 
create multiple output files, an equal sign (=) must be 
coded in one or more of the identifier fields. If there is 
only one input file, fileido may be omitted, in which case 
it defaults to = = = (the input file represented by fileidil 
is replaced) . 

The COPYFILE command options are listed below, briefly. For usage 
notes and examples, see "Using the COPYFILE Command," following the 
option descriptions. 
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Options : 
TYPE 

NOTYPE 

HEWDATE 

OLDDATE 

NEW FILE 



REPLACE 



PROMPT 



NOPROMPT 



displays, at the terminal, the names of the files being 
copied. 

suppresses the display of the names of the files being 
copied. 

uses the current date as the creation date of the new 
file(s) . 

uses the date on the first input file as the creation 
date of the new f ile (s) . 

checks that files with the same fileid as the output file 
do not already exist. if one or more output files do 
exist, an error message is displayed and the COPYFILE 
command terminates. This option is the default so that 
existing files are not inadvertently destroyed. 

causes the output file to replace an existing file with 
the same file identifier. REPLACE is the default option 
when only one fileid is entered or when the output fileid 
is specified as »= = =." 

displays the messages which request specification or 
translation lists. 

suppresses the display of prompting messages for 
specification and translation lists. 



Coj>y Extent Options: 

FROM recno is the starting record number for each input file in the 
copy operation. 

FRLABEL xxxxxxxx 

xxxxxxxx is a character string which appears at the 
beginning of the first record to be copied from each 
input file. Up to 8 nonblank characters may be 
specified. 

FOR numrec is the number of records to be copied from each input 
file. 



TOLABEL XXXXXXXX 

xxxxxxxx is a character string which, if at the beginning 
of a record, stops the copy operation for that input 
file. The record containing the given character is not 
copied. Up to 8 nonblank characters may be specified. 



SPECS 



NOJ>PECS 
OVLY 



indicates that you are going to enter a specification 
list to define how records should be copied. See 
"Entering a COPYFILE Specification List" for information 
on how you can define output records in a specification 
list. 

indicates that no specification list is to be entered. 

overlays the data in an existing output file with data 
from the input file. You can use OVLY in conjunction 
with the SPECS option to overlay data in particular 
columns. 
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APPEND appends the data from the input file at the end 
output file. 



of the 



Data Modification Options: The following options can be used to 
change the record format of a file. See "Modifying Record Formats" 
for more details. 



RECFM 



) is the record format of the output files. If not 
J specified, the output record format is the 



specified, the output 
of the input file. 



same as that 



LRECL nnnnn is the logical record length of the output f ile (s) if it 
is to be different from that of the input f ile (s) . The 
maximum value of nnnnn is 65535. 



TRUNC 



NOTRUNC 



PACK 



UNPACK 



FILL c 
FILL hh 
FILL 40 



removes trailing blanks (or fill characters) when 
converting fixed-length files to variable-length format. 

suppresses the removal of trailing blanks (or fill 
characters) when converting fixed-length files to 
variable- length format. 

compresses records in a file, so that they can be stored 
in packed format. 

Caution: A file in packed format should not be modified 
in any way. If such a file is modified, the UNPACK 
routines are unable to reconstruct the original file. 

reverses the PACK operation. If a file is inadvertently 
packed twice, you can restore the file to its original 
unpacked form by issuing the COPYFILE command twice. 

is the padding and truncation character for the TRUNC 
option or the principal packing character for the PACK 
option. The fill character may be specified as a single 
character, c, or by entering a 2-digit hexadecimal 
representation of a character. The default is 40 (the 
hexadecimal representation for a blank in EBCDIC) . 



Character Translation pjotions: 

EBCDIC converts a file that was created with 026 keypunch 
characters (BCD) , to 029 keypunch characters (EBCDIC) . 
The following conversions are made: 



{ 


to 


) 


s 


to 


+ 


% 


to 


( 


* 


to 


= 


a 


to 


1 


t 


to 


: 



UPCASE converts all lowercase characters in each record to 
uppercase before writing the record to the output file. 

LOWCASE converts all uppercase characters in each record to 
lowercase before writing the record to the output file. 

TRANS indicates that you are going to enter a list of character 
translations to be made as the file is copied. See 
"Entering Translation Specifications" for details on 
entering a list of characters to be translated. 
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IS£om£atible Ofitions 



Figure 4 shows combinations of options which should not be specified 
together in the same COPYFILE command. If the option in the first 
column is specified, none of the options in the second column can be 
coded. 



Option | Incompatible Options 

APPEND | LRECL, NEWDATE, NEWFILE, OLDDATE, OVLY, PACK, RECFM, 

| REPLACE, UNPACK 

EBCDIC | PACK, UNPACK 

FOR | PACK, TOLABEL, UNPACK 

FRLABEL | FROM, PACK, UNPACK 

FROM | FRLABEL, PACK, UNPACK 

LOWCASE | PACK, UNPACK 

LRECL | APPEND, PACK, UNPACK 

NEWDATE | APPEND, OLDDATE 

NEWFILE | APPEND, OVLY, REPLACE 

NOPROMPT | PROMPT 

NOSPECS | PACK, SPECS, UNPACK 

NOTRUNC | PACK, TRUNC, UNPACK 

NOTYPE | TYPE 

OLDDATE | APPEND, NEWDATE 

OVLY | APPEND, NEWFILE, PACK, REPLACE, UNPACK 

PACK | APPEND, EBCDIC, FOR, FRLABEL, FROM, LOWCASE, LRECL, 

| OVLY, RECFM, SPECS, TOLABEL, TRANS, TRUNC, UNPACK, 

| UPCASE 

PROMPT | NOPROMPT 

RECFM | APPEND, PACK, UNPACK 

REPLACE | APPEND, NEWFILE, OVLY 

SPECS | NOSPECS, PACK, UNPACK 

TOLABEL | FOR, PACK, UNPACK 

TRANS | PACK, UNPACK 

TRUNC | NOTRUNC, PACK, UNPACK 

TYPE | NOTYPE 

UNPACK | APPEND, EBCDIC, FOR, FRLABEL, FROM, LOWCASE, LRECL, 

| OVLY, PACK, RECFM, SPECS, TOLABEL, TRANS, TRUNC, 

| UPCASE 

UPCASE | PACK, UNPACK 

Figure 4. COPYFILE Option Incompatibilities 



I Using the COPYFILE Command 

| The simplest use of the COPYFILE command is for copying a single CMS 

| file from one disk to another, or making a duplicate copy of the file on 

| the same disk. For example, 

| copyfile testl assemble a test2 assemble a 

| makes a copy of the file TEST1 ASSEMBLE A and names it TEST2 ASSEMBLE 

J A. For those portions of the file identifier that you want to stay the 

| same, you may code an equal sign in the output fileid. Thus, the 

| command line above can be entered: 

I copyfile testl assemble a test2 = = 

I When you copy a file from one virtual disk to another, you specify 

S the old and new filemodes, and any filename or filetype change you want 
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to make, for example, 

copyfile test3 assemble c good = a 

This command makes a copy of the file TEST3 ASSEMBLE C, and names it 
GOOD ASSEMBLE A. 

If you want to copy only particular records in a file, you can use 
the FROM/FOR FRLABEL/TOLABEL options. For example, 

copyfile old test a new test a (frlabel start for 41 

copies 41 records from the file OLD TEST A1, beginning with the record 
beginning with the character string START into the file NEW TEST A1. 

Multiple Input and Output Files 

You can combine two or more files into a single file with the COPYFILE 
command. For example, 

copyfile test datal a test data2 = test data3 b 

copies the files TEST DATA1 and TEST DATA2 from your A-disk and combines 
them into a file, TEST DATA3, on your B-disk. 

If you want to combine two more files without creating a new file, 
use the APPEND option. For example, 

copyfile new list a old list a (append 

appends the file NEW LIST A to the bottom of the existing file OLD LIST 
A. 

Whenever you code an asterisk (*) in an input fileid, you may cause 
one or more files to be copied, depending on the number of files that 
satisfy the remaining conditions. For example, 

copyfile * test a combined test a 

copies all files with a filetype of TEST on your A-disk into a single 
file named COMBINED TEST. If only one file with a filetype of TEST 
exists, only that file is copied. 

If you want to copy all the files on a particular disk to another 
disk, you could enter 

copyfile * * b = = a 

All the files on the B-disk are copied to the A-disk. The filenames and 
filetypes remain unchanged. 

You can also copy a group of files and change all the filenames or 
all the filetypes. For example, 

copyfile * assemble b = test a 

copies all ASSEMBLE files in the B-disk into files with a filetype of 
TEST on the A-disk. The filenames are not changed. 

Whenever an asterisk appears it indicates "all;" whenever an egual 
sign appears, it indicates "the same." For example 

copyfile x * a1 = file = 
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| combines all files with a filename of X on the A-disk into a single file 

J named X FILE A1. 

| Whenever an equal sign appears in the output fileid in a position 

| corresponding to an asterisk in an input fileid, multiple input files 

| produce multiple output files. When you perform copy operations of this 

| nature you might wish to use the TYPE option, which displays the names 

j of files being copied. For example, 

| copyfile * test a = output a = summary = (type 

| might result in the display 

| COPY 'ALPHA TEST A1» TO 'ALPHA SUMMARY A1' (NEW FILE) 
| COPY 'ALPHA OUTPUT A' 

| COPY 'BETA TEST AT' TO 'BETA SUMMARY A1' (NEW FILE) 
| COPY 'BETA OUTPUT A.' 

i which indicates that files ALPHA TEST A and ALPHA OUTPUT A were copied 

I into a file named ALPHA SUMMARY A and that files BETA TEST A and BETA 

I OUTPUT A were copied into a file named BETA SUMMARY A. 

I Mo^ifliELS Jtecord Formats 



You can use the RECFM and LRECL options to change the record format of a 
file as you copy it. For example, 

copyfile data file a (recfm f lrecl 130 

converts the file DATA FILE A1 to fixed-length 130-character records. 
If you specify an output fileid, for example, 

copyfile data file a fixdata file a (recfm f lrecl 130 

the original file remains unchanged. The file FIXDATA FILE A contains 
the converted records. 

If the records in a file being copied are variable-length, each 
output record is padded with blanks to the specified record length. If 
any records are longer than the record length, they are truncated. 

When you convert files from fixed-length records to variable-length 
records, you can specify the TRUNC option to ensure that all trailing 
blanks are truncated: 

copyfile data file a (recfm v trunc 

If you specify the LRECL option and RECFM V, the LRECL option is 
ignored; the output record length is taken from the longest record in 
the input file. 

When you convert a file from variable-length to fixed-length records, 
you may also specify a fill character to be used for padding instead of 
a blank. If you specify 

copyfile short recs a (recfm f fill * 

then each record in the file SHORT RECS is padded with asterisks to the 
record length. Assuming that SHORT RECS was originally a 
variable-length file, the record length is taken from the longest 
existing record. Note that if SHORT RECS is already fixed-length, it is 
not altered. 
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Similarly, when you are converting back to variable-length a file 
that was padded with a character other than a blank, you must specify 
the FILL option to indicate the pad character, so that character is 
truncated. 

The FILL option can also be used to specify the packing character 
used with the PACK option. When you use the PACK option, a file is 
compressed as follows: all occurrences of two or more blanks are 
encoded as 1 character, and 4 or more occurrences of any other character 
are written as 3 characters. If you use the FILL option to specify a 
fill character, then that character is treated as a blank when records 
are compressed. You must, of course, specify the FILL option to unpack 
any files packed in this way. Since most fixed-length files are 
blank-padded to the record length, you do not need to specify the FILL 
option unless you know that some other character appears more 
frequently. 

When you convert record formats on packed files with the COPYFILE 
command you can specify single or multiple output files, in accordance 
with the procedures outlined under "Modifying Record Formats." For 
example, 

copyfile * assemble a (pack 

compresses all ASSEMBLE files in the A-disk without changing any file 
identifiers. The command 

copyfile * assemble a = script = (recfm trunc 

converts all ASSEMBLE files to variable-length, and changes their 
filetypes to SCRIPT. 

IfitSlillSL a COPYFILE Specification List 

When you use the COPYFILE command, you can specify particular columns of 
data to be manipulated or particular characters to be translated. 
Again, how you specify the file identifier determines how many files are 
copied or modified. 

When you use the SPECS option on the COPYFILE command, you receive 
the message: 

DMSCPY601R ENTER SPECIFICATION LIST: 

and a read is presented to your virtual machine and you may enter a 
specification list. If you do not wish to receive this message, use the 
NOPROMPT option. The specification list you enter may consist of one or 
more pairs of operands in the following format: 

|nn-mm ) 

\ /string/ } col 

( hxx. ) 

where : 

nn-mm specifies the start and end columns of the input file that are to 
be copied to the output file. If mm exceeds the length of the 
input record, the end of the record is the assumed ending 
position. 

string is any string of uppercase and lowercase characters or numbers 
delimited by any non-alphameric character. 
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| hxx... is an even number of hexadecimal digits prefixed with an h. 

| col is the column in the output file at which the copy operation is 
| to begin. 

| You can enter as many pairs of specifications as you wish. If you 

| want to enter more than one line of specifications, enter the characters 

| ++ as continuation indicators. 

I A specification list may contain any combination of specification 

| pairs, for example: 

| copyfile sorted list a (specs 

| DMSCPY601R ENTER SPECIFICATION LIST: 

| /|/ 1 1-8 3 /|/ 12 .***. 14 ++ 

| 9-80 18 

| After this command is executed, each record in the file SORTED LIST 

j will look like the following: 

| | oooooooo | *** oooo.... 

| where the ©•s in columns 3 through 10 indicate information originally in 

I columns 1 through 8; the o's following the asterisks indicate the 

| remainder of each record, columns 9 through 80. 

j When you enter a specification list, you are actually constructing a 

| file column by column. If you specify multiple input or output files, 

j the same copy operation is performed for each record in each output 

| file. 

| Those columns for which you do not specify any data are filled with 

| blanks or, if you use the FILL option, the fill character of your 

| choice. For example, 

I copyfile sorted list a (specs noprompt lrecl 20 fill $ 
I 1-15 6 

| copies columns 1 through 15 beginning in column 6 and writes dollar 

| signs ($) in columns 1 through 5. 

f If you do want to modify data in particular columns of a file but 

| want to leave all of the rest of each record unchanged, you can use the 

I OVLY (overlay) option. For example, the seguence 

I COPYFILE * bracket a (specs ovly noprompt 
| had 1 hbd 80 

| overlays the characters [ (X*AD) and ] (X^D 1 ) in columns 1 and 80 of 

| all the files with a filetype of BRACKET on your A-disk. 

I When you copy fixed-length files, records are padded or truncated to 

I the record length; variable-length files are always written as 

| specified. 

I Entering Translation Sj>ecif ications 

| You can perform conversion on particular characters in CMS files or 

I groups of files with the TRANS option of the COPYFILE command. 

I When you enter the TRANS option, you receive the message 

| DMSCPY602R ENTER TRANSLATION LIST: 
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and a read is presented to your virtual machine. You may enter the 
translation list. If you do not wish to receive this message, use the 
NOPROMPT option. 

A translation list consists of one or more pairs of characters or hex 
digits, each pair representing the character you want to translate and 
the character you want to translate it to, respectively. For example, 

copy test file a (trans 
DMSCPY602R ENTER TRANLATION LIST: 
* - A fO 00 ff 

specifies that all occurrences of the character * are to be translated 
to -, all character A's are to be translated to X'FO' and all X'00's are 
to be translated to X'FF's. 

If any translation specifications you enter conflict with the 
LOWCASE, EBCDIC, or UPCASE options specified on the same command line, 
the translation list takes precedence. In the preceding example, if 
LOWCASE had also been specified, all A's would be translated to X'FO's, 
not to a's. 

You can enter translation pairs on more than one line if you enter a 
++ as a continuation indicator. 

Responses 

DMSCPY601R ENTER SPECIFICATION LIST: 

This message prompts you to enter a specification list when you use 
the SPECS option. 

DMSCPY602R ENTER TRANSLATION LIST: 

This message prompts you to enter a translation list when you use 
the TRANS option. 

DMSCPY721I COPY • f n ft fm» [TO | APPEND | OVLY } 'fn ft fra» [OLD|NEW] FILE 

This message appears for each file copied with the TYPE option. It 
indicates the names of the input file and output file. When you 
have multiple input files, the output fileid is displayed only 
once. 



Other Messages and Return Codes 

DMSCPY002E { INPUT | OVERLAY } FILE • f n ft fm' NOT FOUND RC=28 

DMSCPY003E INVALID OPTION •option* RC=24 

DMSCPY024E FILE 'fn ft fm' ALREADY EXISTS -.- SPECIFY 'REPLACE' RC=28 

DMSCPY029E INVALID PARAMETER 'parameter' IN THE OPTION 'option' FIELD 

RC=24 
DMSCPY030E FILE 'fn ft fm» ALREADY ACTIVE RC=28 
DMSCPY037E DISK 'mode' IS READ/ONLY RC=36 
DMSCPY042E NO FILEID (S) SPECIFIED RC=24 
DMSCPY048E INVALID MODE 'mode* RC=24 

DMSCPY054E INCOMPLETE FILEID • f n [ft'] SPECIFIED RC=24 
DMSCPY062E INVALID CHAR »[=|*|char]» IN FILEID »[fn ft fm]« RC=20 
DMSCPY063E NO { TRANSLATION | SPECIFICATION } LIST ENTERED RC=U0 
DMSCPY06UE INVALID [TRANSLATE] SPECIFICATION AT OR NEAR ' ' 

RC=24 
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DMSCPY065E 'option* OPTION SPECIFIED TWICE RC = 24 

DMSCPY066E 'option* AND 'option* ARE CONFLICTING OPTIONS RC=24 

DMSCPY067E COMBINED INPUT FILES ILLEGAL WITH PACK OR UNPACK OPTIONS 

RC=2U 
DMSCPY068E INPUT FILE ' f n ft fm' NOT IN PACKED FORMAT RC=32 

DMSCPY101S 'SPECS' TEMP STRING STORAGE EXHAUSTED AT ' • RC=88 

DMSCPY102S TOO MANY FILEIDS RC=88 

DMSCPY103S NUMBER OF SPECS EXCEEDS MAX 20 RC=88 

DMSCPY156E 'FROM nnn' NOT FOUND —FILE «fn ft fm' HAS ONLY »nnn» RECORDS 

RC=32 
DMSCPY157E LABEL 'label' NOT FOUND IN FILE »fn ft f m • RC=32 
DMSCPY172E TO LABEL 'label' { EQUALS | IS AN INITIAL SUBSTRING OF} FRLABEL 

•label' RC=24 
DMSCPY173E NO RECORDS WERE COPIED TO OUTPUT FILE ' f n ft fm' RC=40 
DMSCPY901T UNEXPECTED ERROR AT 'addr': PLIST 'plist' AT • addr • , BASE 

•addr', RC 'nn» RC=256 
DMSCPY903T IMPOSSIBLE PHASE CODE 'XX' RC=256 
DMSCPY904T UNEXPECTED UNPACK ERROR AT 'addr', BASE 'addr' RC=256 
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Use the CP command to transmit commands to the VM/370 control program 
environment without leaving the CMS environment. The format of the CP 
command is: 



I CP | [ commandline ] I 

i ', i 

where : 

commandline is any CP command valid for your CP command privilege 
class. If this field is omitted, you are placed in the CP 
environment and may enter CP commands without preceding each 
command with CP. To return to CMS, issue the CP command 
BEGIN. 

Usa^e Notes 

1. You must use the CP command to invoke a CP command: 

• Within an EXEC procedure. 

• If the implied CP (IMPCP) function is set to OFF for your 
virtual machine. 

• In a job you send to the CMS Batch Facility. 

2. To enter a CP command from the CMS environment without CMS 
processing the command line, use the #CP function. 

| 3. When you enter an invalid CP command following the CP command, you 
| receive a return code of -1. In an EXEC, this return code is +1. 

Responses 

All responses are from the CP command that was issued, and are followed 
by the CMS Ready message. 
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Use the DASD Dump Restore (DDR) program to dump, restore, copy, or print 
VM/370 user minidisks. The DDR program may run as a standalone program, 
or under CMS via the DDR command. 

The DDR program has five functions: 

1. Dumps part or all of the data from a DASD device to tape. 

2. Transfers data from tapes created by the DDR dump function to a 
direct access device. The direct access device must be the same as 
that which originally contained the data. 

3. Copies data from one device to another of the same type. Data may 
be reordered, by cylinder, when copied from disk to disk. In order 
to copy one tape to another, the original tape must have been 
created by the DDR DUMP function. 

4. Prints selected parts of DASD and tape records in hexadecimal and 
EBCDIC on the virtual printer. 

5. Displays selected parts of DASD and tape records in hexadecimal and 
EBCDIC on the terminal. 

The format of the DDR command is: 



I i r n I 

| DDR | [fn ft |f m| ] I 

111*1 I 

I I L J I 



w her e : 

r t 

fn ft | f id | is the identification of the file containing the control 

|* | statements for the DDR program. If no file 

*- J identification is provided, the DDR program attempts to 

obtain control statements from the console. The filemode 

defaults to * if a value is not provided. 

S2te: If you use the CMS DDR command, CMS ignores the SYSPRIHT control 
statement and directs the output to the CMS printer 00E. 

I Mote: Be aware that DDR when run as a standalone program does not have 

| error recovery support. However, when DDR is invoked in CMS, in a 

I virtual machine environment, the I/O operation is performed by CP (CP 

| has built-in error recovery facilities) . 



DDR Control Statements 

DDR control statements describe the intended processing and the needed 
I/O devices. I/O definition statements must be specified first. 

All control statements may be entered from either the console or the 
card reader. Only columns 1 to 71 are inspected by the program. All 
data after the last operand in a statement is ignored. An output tape 
must have the DASD cylinder header records in ascending seguences; 
therefore, the extents must be entered in seguence by cylinder. Only 
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one type of function — dump, restore, or copy — may be performed in 
one execution, but up to 20 statements describing cylinder extents may 
be entered. The function statements are delimited by an INPUT or OUTPUT 
statement, or by a null line if the console is used for input. If 
additional functions are to be performed, the sequence of control cards 
must be repeated. If you do not use INPUT or OUTPUT control statements 
to separate the functions you specify when the input is read from a card 
reader or CMS file, an error message (DMKDDR702E) is displayed. 
However, the remainder of the input stream will be checked for proper 
syntax, but no further DDR operations will be performed. Only those 
statements needed to redefine the I/O devices are necessary for 
subsequent steps. All other I/O definitions remain the same. 

To return to CMS, enter a null line (carriage return) in response to 
the prompting message (ENTER:). To return directly to CP, key in #CP. 

The PRINT and TYPE statements work differently from other DDR control 
statements in that they operate on only one data extent at a time. If 
the input is from a tape created by the dump function, it must be 
positioned at the header record for each step. The PRINT and TYPE 
statements have an implied output of either the console (TYPE) or system 
printer (PRINT) . Therefore, PRINT and TYPE statements need not be 
delimited by an INPUT or OUTPUT statement. 



I/O Definition Statements 



The I/O definition statements describe the tape, DASD, and printer 
devices used while executing the DASD Dump Restore program. 

INPUT/OUTPUT Control Statement 

An INPUT or OUTPUT statement describes each tape and DASD unit used. 
The format of the INPUT/OUTPUT statement is: 




r t 

cuu type |volser| [(options 

|altape| 

L J 

Op t i on s : 

r i r 

ISKip nn | |MOde 

|SKi£ | |MOde 

<■ J | MOde 

L 



) ] 



i r i 

6250 | |REwind| 

1600 | |UNload| 

800 | |LEave | 

J L J 



where : 
INPUT 
OUTPUT 
cuu 
I type 



indicates that the device described is an input device. 

indicates that the device described is an output device. 

is the unit address of the device. 

is the device type (2314, 2319, 3330, 3330-11, 3340-35, 
3340-70, 3350, 2305-1, 2305-2, 2400, 2420, or 3420) (no 
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volser 



a 1 tape 



7-track support for any tape devices) . Specify a 341 device 
as a 3420, a 3340-70F as a 3340-70, and a 3333 as a 3330. 
Specify a 3350 that is in 3330—1 or 3330—11 compatibility mode 
as a 3330 or 3330-11. Specify a 3344 as a 3340-70, and 
specify 3350 for a 3350 operating in native mode (as opposed 
to compatibility mode) . 

Note: The DASD Dump Restore (DDR) program, executing in a 
virtual machine, uses I/O DIAGNOSE 20 to perform I/O 
operations on tape and DASD devices. DDR under CHS requires 
that the device type entered agree with the device type of the 
real device as recognized by VM/370. If there is a conflict 
with device types, the following message is issued: 

DMKDDR708E INVALID OPTION 

However, if DDR executes standalone in a virtual machine, DDR 
uses DIAGNOSE 20 to perform the I/O operation if the device 
types agree. If the device types do not agree, error message 
DMKDDR708E is issued. 

is the volume serial number of a DASD device. If the keyword 
"SCRATCH" is specified instead of the volume serial number, no 
label verification is performed. 

is the address of an alternate tape drive. 

J52i§ : If multiple reels of tape are required and "alt ape" is 
not specified, DDR types the following at the end of the reel: 



END OF VOLUME CYL XXX HD XXX, MOUNT NEXT TAPE 

After the new tape is mounted, DDR continues automatically. 

Options : 

SKIP nn forward spaces nn files on the tape, nn is any number 
up to 255. The SKIP option is reset to zero after the 
tape has been positioned. 

r i 

MODE 1 6250 1 causes all output tapes that are opened for the first 

| 1600| time and at the load point to be written or read in 

| 800 | the specified density. All subsequent tapes mounted 

*• J are also set to the specified density. If no mode 

option is specified, then no mode set is performed and 

the density setting remains as it previously was. 

REWIND rewinds the tape at the end of a function. 

UNLOAD rewinds and unloads the tape at the end of a function. 

LEAVE leaves the tape positioned at the end of the file at 
the end of a function. 

Note: When the wrong input tape is mounted, the message DMKDDR709E 
is displayed and the tape will rewind and unload regardless of 
options REWIND, UNLOAD, or LEAVE being specified. 

SYSPRINT Control Statement 

Use the SYSPRINT control statement (in the standalone DDR virtual 
machine only) to describe the printer that is to print data extents 
specified by the PRINT statement. It also can print a map of the 
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cylinder extents from the DUMP, RESTORE, or COPY statement. If the 
SYSPRINT statement is not provided, the printer assignment defaults to 
00E. CMS ignores the SYSPRINT statement when you invoke DDR as a 
command under CMS, and CMS always directs the output to 00E. The format 
of the SYSPRINT control statement is: 



| SYsprint | cuu 

w her e : 

cuu specifies the unit address of the device. 

I^BSiiSIi Statements 

The function statements tell the DDR program what action to perform. 
The function commands also describe the extents to be dumped, copied, or 
restored. The format of the DUMP/COPY/RESTORE control statement is: 



DUmp 
copy 
REstore 



|cyl1 [To] 
| CPvol 
I ALL 
| Nucleus 

L 



[cyl2 [Reorder] [To] [cyl3]] | 



i 



where : 
DUMP 



COPY 



RESTORE 



reguests the program to move data from a direct access volume 
onto a magnetic tape or tapes. The data is moved cylinder by 
cylinder. Any number of cylinders may be moved. The format 
of the resulting tape is: 



JH§£°.E<I 1' a volume 
describing the volumes 



header record, consisting of data 



Record 2: a track header record, consisting of a list of count 
fields to restore the track, and the number of data records 
written on tape. After the last count field the record 
contains key and data records to fill the 4K buffer. 

R§£2ESl 3: track data records, consisting of key and data 
records packed into 4K blocks, with the last record 
truncated. 

Record 4: either the end— of-volume (EOV) or end-of-job (EOJ) 
trailer label. The end— of— volume label contains the same 
information as the next volume header record, except that the 
ID field contains EOV. The end— of-job trailer label contains 
the same information as record 1 except that the cylinder 
number field contains the disk address of the last record on 
tape and the ID field contains EOJ. 

reguests the program to copy data from one device to another 
device of the same or eguivalent type. Data may be recorded 
on a cylinder basis from input device to output device. A 
tape— to-tape copy can be accomplished only with data dumped by 
this program. 

reguests the program to return data that has been dumped by 
this program. Data can be restored only to a DASD volume of 
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the same or equivalent device type from which it was dumped. 
It is possible to dump from a real disk and restore to a 
minidisk as long as the device types are the same. 

cyll [TO] [cyl2 [REOBDER] [TO] [cyl3]] 

Only those cylinders specified are moved, starting with the 
first track of the first cylinder (cyll) , and ending with the 
last track of the second cylinder (cyl2) . The REORDER operand 
| causes the output to be reordered, that is, moved to different 

| cylinders, starting at the specified cylinder (cyl3) or at the 

starting cylinder (cyll) if "cyl3" is not specified. The 
REORDER operand must not be specified unless specified limits 
are defined for the operation; the starting and, if required, 
ending cylinders (cyll and cyl2) must be specified. 

CPVOL specifies that cylinder and all active directory and 
permanent disk space are to be copied, dumped, or restored. 
This indicates that both source and target disk must be in CP 
format, that is, the CP Format/Allocate program must have 
formatted them. 

ALL specifies that the operation is to be performed on all 
cylinders. 

NUCLEUS specifies that record 2 on cylinder 0, track and the nucleus 
cylinders are dumped, copied, or restored. 

E®s trie t ions : 

• Each track must contain a valid home address, containing the real 
cylinder and track location. 

• Record zero must not contain more than eight key and/or data 
characters. 

« Flagged tracks are treated just as any other track for all 2314, 
2319, 3340, and 2305 devices. That is, no attempt is made to 
substitute the alternate track data when a defective primary track is 
read. In addition, tracks are not inspected to determine whether 
they were previously flagged when written. Therefore,, volumes 
containing flagged tracks should be restored to the same cylinders of 
the volume from which they were dumped. The message DMKDDR715E occurs 
each time a defective track is dumped, copied or restored,, and the 
operation continues. 

| » Flagged tracks for 3330 and 3350 devices are handled automatically by 
the control unit and may never be detected by the program. The 
program may detect a flagged track if, for example, no alternate 
track is assigned to the defective primary track. If a flagged track 
is detected by the program, the message DMKDDR715E occurs and the 
operation terminates. 
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Ex a m£l e : 

INPUT 191 3330 SYSRES 

OUTPUT 180 2400 181 (MODE 800 

SYSPRINT OOF 

DUMP CPVOL 

INPUT 130 3330 MINI01 

DUMP 1 TO 50 REORDER 51 

60 70 101 

This example sets the density to 800 bpi, then dumps all pertinent 
data from the volume labeled SYSRES onto the tape that is mounted on 
unit 180. If the program runs out of space on the first tape, it 
continues dumping onto the alternate device (181). A map of the dumped 
cylinders is printed on unit OOF while the program is dumping. When the 
first function is complete, the volume labeled MINI01 is dumped onto a 
new tape. Its cylinder header records are labeled 51 to 100. A map of 
the dumped cylinders is printed on unit 00F. Next, cylinders 60 to 70 
are dumped and labeled 101 to 111. This extent is added to the cylinder 
map on unit OOF. When the DDR processing is complete, the tapes are 
unloaded and the program stops. 

If cylinder extents are being defined from the console, the following 
is displayed: 

ENTER CYLINDER EXTENTS 
ENTER: 

For any extent after the first extent, the message 

ENTER NEXT EXTENT OR NULL LINE 
ENTER: 

is displayed. 

You may then enter additional extents to be dumped, restored, or 
copied. A null line causes the job step to start. 

Note: When a cylinder map is printed on the virtual printer (OOF as in 
the previous example) a heading precedes the map information. Module 
DMKDDR controls the disk, time and zone printed in the heading. Your 
installation must apply a local modification to DMKDDR to insure that 
local time, rather than GMT (Greenwich Meridian Time) , is printed in the 
heading. 

PJiOT/TYPE Function Statement 

Use the PRINT and TYPE function statement to print or type (display) a 
hexadecimal and EBCDIC translation of each record specified. The input 
device must be defined as direct access or tape. The output is directed 
to the system console for the TYPE function, or to the SYSPRINT device 
for the PRINT function. (This does not cause redefinition of the output 
unit definition.) The format of the PRINT/TYPE control statement is: 



| PRint | cyll [hh1 [rr1]] [To cyl2 [hh2 [rr2 ]]] [ (options ...[) ]] | 

I TYpe | | 

I I 2E£i°.fis: I 

I | [Hex] [Graphic] [Count] | 
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w h er e : 

cyll is the starting cylinder. 

hh1 is the starting track. If present, it must follow the cyll 
operand. The default is track zero. 

rr1 is the starting record. If present, it must follow the hh1 
operand. The default is home address and record zero. 

TO cyl2 is the ending cylinder. If more than one cylinder is to be 
printed or typed "TO cyl2" must be specified. 

hh2 is the ending track. If present, it must follow the cyl2 
operand. The default is the last track on the ending 
cylinder. 

rr2 is the record ID of the last record to print. The default is 
the last record on the ending track. 

Opt ion s : 

HEX prints or displays a hexadecimal representation of each 
record specified. 

GRAPHIC prints or displays an EBCDIC translation of each record 
specified. 

COUNT prints or displays only the count field for each record 
specified. 



Ex ampl es : 
PRINT TO 3 

Prints all of the records from cylinders 0, 1, 2, and 3. 
PRINT 1 3 

Prints only one record, from cylinder 0, track 1, record 3. 

PRINT 1 10 3 TO 1 15 4 

Prints all records starting with cylinder 1, track 10, record 3, and 
ending with cylinder 1, track 15, record 4. 

The example in Figure 5 shows the information displayed at the 
console (TYPE function) or system printer (PRINT function) by the DDR 
program. The listing is annotated to describe some of the data fields. 



Responses 



DMKDDR711R VOLID READ IS volid2 [NOT volidl] 

DO YOU WISH TO CONTINUE? RESPOND YES NO OR REREAD: 
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Home Address- 
Record 



1st Half of - 
Record 2 



Home Address 
Record 

2nd Half of 
Record 2 



CYL 019 HD 00 HOWIE ADDRESS 0000130000 RECORD ZERO 0013000000 



*~ JCYL 019 HP OOJ 



Cylinder and head 
identification for 
Record 



Home Address of track 
in hexadecimal format 



Record ID from the 
count field 




*- ICYL019HD 00 REC 001 1 COUNT 0013000001 



"A 



Cylinder, head, and 
record numbers in 
decimal 




If the data length field is not zero I 

m A heading is printed containing the 

data length from the count field first in I 
decimal, then in hexadecimal . 

The data is then printed in hexadecimal 
with graphic interpretation at the right 
(not shown here). 



04096 1000 DATA LENGTH 



00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 



CYL 019. HD 00 REC 002 COUNT 0013000002 fJO |09A8| 



02472 109A8I DATA LENGTH 



Note: Data Length field repeated 
in heading. 



00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 



ABOVE RECORD WRITTEN USING RECORD OVERFLOW 



This statement indicates that this portion ■ 
of Record 2 was written using the Write I 

Special Count, Key, and Data command. The 
remainder of Record 2 is found on the next I 
track as the first record after Record 0. 



CYL 019 HD 01 HOME ADDRESS 0000130001 RECORD ZERO 0013000100 00 0008 00000000 00000000 

-CYL 019 HD 01 REC 002 COUNT 0013000102 00 0658-* 

01624 0658 DATA LENGTH 

00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 



e 



CYL 019 HD 01 REC 003 COUNT 0013000103 80 0F80 
00128 0080 KEY LENGTH—* 




. Q If th e key length field is not zero 

I 9 A heading is printed containing the key length 

first in decimal, then in hexadecimal. 
The key is then printed in hexadecimal with 
graphic interpretation at the right (not shown here). 



00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 

03968 0F80 DATA LENGTH 

00000 0000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
SUPPRESSED CHARACTERS SAME AS ABOVE . . . 



CYL 019 HD 01 REC 004 COUNT 0013000104 00 0000 
END OF FILE RECORD- 



o 



Whenever the data length field is zero I 

an end-of-file prints next. I 



Figure 5. An Annotated Sample of Output from the TYPE and PRINT 
Functions of the DDR Program 
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where : 

volid2 is the volume serial number from the V0L1 label on the 
DASD unit. 

volidl is the volume serial number from the INPUT or OUTPUT 
control card. 

The volume serial number read from the device at cuu is not the 
same as that specified on the INPUT or OUTPUT control card. 

DMKDDR716R NO V0L1 LABEL FOUND FOR volser 

DO YOU WISH TO CONTINUE? RESPOND YES NO OR REREAD: 

where : 

volser is the volume serial number of the DASD device from the 
INPUT or the OUTPUT control card. 

The DASD device at cuu contains no volume serial number. 

DMKDDR717R DATA DUMPED FROM volidl TO BE RESTORED TO volid2 

DO YOU WISH TO CONTINUE? RESPOND YES NO OR REREAD: 

where : 

volidl is the volume serial number from the input tape header 
record (volume dumped) . 

volid2 is the volume serial number from the output DASD device. 

The above message is printed to verify the input parameters. 

ENTER CYLINDER EXTENTS 
ENTER: 

This message is received only if you are entering input from your 
terminal. 

END OF VOLUME CYL XXX HD XX, MOUNT NEXT TAPE 

DDR continues processing, after the mounting of the next tape 
reel. 

| RESTORING volser 
where : 

volser is the volume serial number of the disk dumped. 
The RESTORE operation has begun. 

COPYING volser 
where : 

volser is the volume serial number described by the input unit. 
The COPY operation has begun. 
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DUMPING volser 
where : 

volser is the volume serial number described by the input unit. 
The DUMP operation has begun. 

PRINTING volser 
where : 

volser is the volume serial number described by the input unit. 
The PRINT operation has begun. 

END OF DUMP 

The DUMP operation has ended. 

END OF RESTORE 

The RESTORE operation has ended. 

END OF COPY 

The COPY operation has ended. 

END OF PRINT 

The PRINT operation has ended. 

END OF JOB 

All specified operations have completed. 

ENTER: 

Prompts input from the terminal. A null line (that is, pressing 
the Enter key or eguivalent) causes control to return to CMS, if 
the virtual machine is in the CMS environment. 

DMKDDR725R ORIGINAL INPUT DEVICE WAS (IS) LARGER THAN OUTPUT DEVICE. 
DO YOU WISH TO CONTINUE? RESPONSE YES OR NO: 

IXEiana t i on : 

RESTORE function - The number of cylinders on the original DASD 

input unit is compared with the number of cylinders on the output 

device. 

COPY function - The input device contains more cylinders than the 
output device. 

P.ESiEi|tor lotion: The operator must determine if the COPY or RESTORE 
function is to continue. The response is either yes or no. 
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I Other Messages and Return Codes 

J?°.te: There is no return code returned for the following messages, 
unless otherwise noted. 

DMKDDR700E INPUT UNIT IS NOT A CPVOL 

DMKDDR701E INVALID OPERAND - operand 

DMKDDR702E CONTROL STATEMENT SEQUENCE ERROR 

DMKDDR703E OPERAND MISSING 

DMKDDR704E DEV cuu NOT OPERATIONAL 

DMKDDR705E 10 ERROR cuu CSW csw SENSE sense INPUT bbcchh OUTPUT bbcchh 

CCW ccw 

DMKDDR707E MACHINE CHECK RUN SEREP AND SAVE OUTPUT FOR CE 

DMKDDR708E INVALID INPUT OR OUTPUT DEFINITION 

DMKDDR709E WRONG INPUT TAPE MOUNTED 

DMKDDR710A DEV cuu INTERVENTION REQUIRED 

DMKDDR712E NUMBER OF EXTENTS EXCEEDS 20 

DMKDDR713E OVERLAPPING OR INVALID EXTENTS 

DMKDDR714E RECORD bbcchh NOT FOUND ON TAPE 

DMKDDR715E LOCATION bbcchh IS A FLAGGED TRACK RC=3 

DMKDDR718E OUTPUT UNIT IS FILE PROTECTED RC=1 

DMKDDR719E INVALID FILENAME OR FILE NOT FOUND 

DMKDDR720E ERROR IN routine RC=varies 

DMKDDR721E RECORD cchhr NOT FOUND 

DMKDDR722E OUTPUT UNIT NOT PROPERLY FORMATTED FOR THE CP NUCLEUS 

DMKDDR723E NO VALID CP NUCLEUS ON THE INPUT UNIT 

DMKDDR724E INPUT TAPE CONTAINS A CP NUCLEUS DUMP 

DMKDDR756E PROGRAM CHECK PSW=psw 
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DEBUG 



Use the DEBUG command to enter the debug environment from the CMS 
environment. In the debug environment you can use a variety of DEBUG 
subcommands that allow you to test and debug your programs. The DEBUG 
subcommands are described in "Section 4. DEBUG Subcommands." For 
tutorial information, including examples, see the VM/370: CMS User^s 
Guide. The format of the DEBUG subcommand is: 



DEBUG 



i 



H§iL3i= Notes 

1. The debug environment is also entered as a result of an external 
interrupt or the result of a breakpoint (address stop) encountered 
during program execution. 

2. Once you are in the debug environment, you can enter only DEBUG 
subcommands and CP commands via the #CP function. 

3. To return to the CMS environment, enter the DEBUG subcommand 
RETURN. 



Responses 

DMSDBG728I DEBUG ENTERED 

This message indicates that you are in the debug environment 
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DISK 

Use the DISK command to: 

• Punch CMS disk files to the virtual spooled card punch in a special 
format which allows the punched deck to be restored to disk in the 
form of the original disk file. 

• Restore punched decks created by the DISK DUMP command to a disk 
file. 

The format of the DISK command is: 



i" 



(D. 



DISK | /DUMP fn ft [fm] 
LOAD 



where: 



DUMP fn ft fm 

punches the specified file (fn ft fm) . The file may have 
either fixed- or variable-length records. After all data is 
punched, an end-of-file card is created with an N in column 
5. This card contains directory information, and must remain 
in the deck. The original disk file is retained. 

LOAD loads a file or files from the spooled card reader and writes 
them as CMS files on your A-disk. The filename and filetype 
are obtained from the card stream. If a file exists with the 
same filename and filetype as one of those in the card stream, 
it is replaced. 

Hsa<je Notes 

1. To read files with the DISK LOAD command, they must have been 
created by the DISK DUMP command. To load spooled reader files 
created in any other manner, you should use the READCARD command. 

2. To load reader files created by DISK DUMP, you must issue the DISK 
LOAD command for each spool file. For example, if you enter 

disk dump sourcel assemble 
disk dump source2 assemble 

the virtual machine that receives the files must issue the DISK 
LOAD command twice to read the files onto disk. If you use the CP 
SPOOL command to spool continuous, for example, 

cp spool punch cont 
disk dump sourcel assemble 
disk dump source2 assemble 
cp spool punch nocont close 

then you only need to issue the DISK LOAD command once to read both 
files. 

Responses 

There is no response to the DISK DUMP command. The file identifiers of 
each file loaded are displayed when you issue the DISK LOAD command: 
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fn ft fm 



Other Messages and Return Codes 



DMSDSK002E FILE 'fn ft fm' NOT FOUND RC=28 

DMSDSK014E INVALID FUNCTION 'function 1 RC=2U 

DMSDSK037E DISK 'A* IS READ/ONLY RC=36 

DMSDSK047E NO FUNCTION SPECIFIED RC=24 

DMSDSK048E INVALID MODE 'mode* RC=24 

DMSDSK054E INCOMPLETE FILEID SPECIFIED RC=2U 

DMSDSK062E INVALID * IN FILEID ['fn ft fm* ] RC=20 

DMSDSK070E INVALID PARAMETER 'parameter' RC=2U 

DMSDSK077E END CARD MISSING FROM INPUT DECK RC=32 

DMSDSK078E INVALID CARD IN INPUT DECK RC=32 

DMSDSK104S ERROR «nn' READING FILE • f n ft fm' FROM DISK RC=100 

DMSDSK105S ERROR • nn • WRITING FILE "fn ft fm' ON DISK RC=100 

DMSDSK118S ERROR PUNCHING FILE RC=100 

DMSDSK12US ERROR READING CARD FILE RC=100 

DMSDSK205W READER EMPTY OR NOT READY RC=8 
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Use the DLBL command: 

• In CMS/DOS, to define DOS and CMS sequential disk files for program 
input/output, and to identify DOS files and libraries; and to define 
and identify VSAM catalogs, clusters, and data spaces, and to 
identify VSAM, DOS, or CMS files used for VSAM program input/output, 
and Access Method Services functions. 

• In CMS, to define and identify VSAM catalogs, clusters, and data 
spaces; to identify VSAM files used for program input/output; and to 
identify input/output files for AMSERV. 

The format of the DLBL command is: 



DLBL 



ddname (mode \ |CMS fn ft | [ (optionA optionB [)]] 
I DOMMYj I CMS FILE ddname | 
u J 



ddname 



( mode )|DSN quail [ qual2. . .qualn 
IDUMMYJIDSN ? 



] I 
I 



ddname CLEAR 
* 

optionA: 
[SYSxxx] 



opt ionB : 
[PERM] 

r n 

| CHANGE | 
|NOCHANGE| 

L J 



[ (optionA optionB optionC [) ]] 



op tio nC : 
[VSAM ] 

r n 

| EXTENT | 
| MULT | 

L J 



[CAT catdd] 
[BUFSP nnnnnn ] 



Note: The operands and options of the DLBL command are described below. 
Usage notes are provided for general usage, followed by additional notes 
for CMS/DOS users, and then additional notes for OS VSAM users. 



where : 
ddname 



specifies a 1- to 7-character program ddname (OS) or filename 
(DOS) , or dname (as specified in the FILE parameter of an 
Access Method Services control statement) . An asterisk (*) 
entered with the CLEAR operand indicates that all DLBL 
definitions, except those that are entered with the PERM 
option, are to be cleared. 



mode specifies a valid CMS disk mode letter and optionally, 

filemode number. A letter must be specified; if a number is 

not specified, it defaults to 1. The disk must be accessed 
when the DLBL command is issued. 

DUMMY specifies that no real I/O is to be performed. A read 
operation results in an end-of-file condition and a write 
operation results in a successful return code. DUMMY should 
not be used for OS VSAM data sets (see Usage Note 3) . 
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CLEAR removes any existing definitions for the specified ddname. 
Clearing a ddname before defining it ensures that a file 
definition does not exist and that any options previously 
defined with that ddname no longer have any effect. 

CMS fn ft indicates that this is a CMS file, and the file identifier (fn 
ft) that follows is a CMS filename and filetype. 

FILE ddname is the default CMS file identifier associated with 
all non-CMS data sets. (See Usage Note 3 for CMS/DOS users.) 

DSN indicates that this is a non-CMS file. 

? indicates that you are going to enter the data set name 
interactively. When prompted, you enter the data set name or 
fileid in its exact form, including embedded blanks, hyphens, 
or periods. 

quail [ qual2. . .qualn] 

is an OS data set name or DOS file-id. Only data sets named 
according to standard OS conventions may be entered this way; 
you must omit the periods between qualifiers. (See Usage Note 
2.) 

Options : 

SYSxxx (CMS/DOS only.) indicates the system or programmer logical 
unit that is associated with the disk on which the disk 
file resides. The logical unit must have been previously 
assigned with the ASSGN command. If a DLBL definition is 
already in effect for the specified ddname, SYSxxx may be 
omitted; otherwise, it is required. 

PERM indicates that this DLBL definition can be cleared only 
with an explicit CLEAR request. It will not be cleared 
when the DLBL * CLEAR command line is entered. 

All DLBL definitions, including those entered with the PERM 
option, are cleared as a result of a program abend or HX 
(halt execution) Immediate command. 

CHANG?! indicates that any existing DLBL for this ddname is not be 
be canceled, but that conflicting options are to be 
overridden and new options merged into the old definition. 
Both the ddname and the file identifier must be the same in 
order for the definitions to be merged. 

NOCHANGE does not alter any existing DLBL definition for the 
specified ddname, but creates a definition if none 
existed. 

VSAM indicates that the file is a VSAM data set. This option 
must be specified for VSAM functions unless the EXTENT, 
MULT, CAT, or BUFSP options are entered, or the ddnames 
IJSYSCT or IJSYSUC are used. 

EXTENT indicates that you are going to use Access Method Services 
to define a VSAM catalog, data space, or unique cluster and 
you want to enter extent information. 

MULT indicates that you are going to reference an existing 
multivolume data set and you want to enter the volume 
specifications. 
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CAT catdd identifies the VSAM catalog (defined by a previous DLBL 
definition) which contains the entry for this data set. You 
must use the CAT option when the VSAM data set you are 
creating or identifying is not cataloged in the current job 
catalog. catdd is the ddname in the DLBL definition for 
the catalog. 

BUFSP nnnnnn 

specifes the number of bytes (in decimal) to be used for 

I/O buffers by VSAM data management during program 

execution, overriding the BUFSP value in the ACB for the 

file. The maximum value for nnnnnn is 999999; embedded 
commas are not permitted. 

H§^3§ Notes 

1. To display all of the current DLBL definitions, enter the DLBL 
command with no operands: 

dlbl 

2. To enter an OS or DOS file identification on the DLBL command line, 
it must consist of 1- to 8-character gualifiers separated by 
periods, with a maximum length of 44 characters, including periods. 
For example, the file TEST. INPUT. SOURCE. D could be identified as 
follows: 

dlbl dd1 c dsn test input source d (options... 

Or, it may be entered interactively, as follows: 

dlbl dd1 c dsn ? (options 
DMSDLB220R ENTER DATA SET NAME: 
test. input. source. d 

Note that when the data set name is entered interactively, the data 
set name must be entered in its exact form; when entered on the 
DLBL command line, the periods must be omitted. 

You must use the interactive form to enter a DOS file-id that 
contains embedded blanks or hyphens. 

3. In DOS/VS, a VSAM data set that has been defined as DUMMY is opened 
with an error code of X'11*. CMS supports the DUMMY operand of the 
DLBL command in the same manner. OS users should not use the DUMMY 
operand in CMS, since a dummy data set does not return, on open, an 
end-of-file indication. 

Additional Notes for CMS/DOS Users 

1. Each DLBL definition must be associated with a system or programmer 
logical unit assignment, previously made with an ASSGN command. 
Specify the SYSxxx option on the first, or only, DLBL definition 
for a particular ddname. Many DLBL definitions may be associated 
with the same logical unit. For example, 

assgn syslOO b 

dlbl dd1 b cms test filel (syslOO 
dlbl dd2 b cms test file2 (syslOO 
dlbl dd1 cms test file3 

is a valid command seguence. 
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2. The following special ddnames must be used to define DOS private 
libraries, and must be associated with the indicated logical units: 

Logical 

ddname Unit hLhl.^L2 

IJSYSSL SYSSLB Source statement 

IJSYSRL SYSRLB Relocatable 

IJSYSCL SYSCLB Core image 

These libraries must be identified in order to perform librarian 
functions (with the SSERV, ESERV, DSERV, or RSERV commands) for 
private libraries; or to link-edit or fetch modules or phases from 
private relocatable or core image libraries (with the DOSLKED and 
FETCH commands) . 

3. Each DOS file has a CMS file identifier associated with it by 
default; the filename is always FILE and the filetype is always the 
same as the ddname. For example, if you enter a DLBL command for 
an DOS file MOD. TEST. STREAM as follows 

dlbl test c dsn mod test stream 

then you can refer to this OS data set as FILE TEST when you use 
the STATE command: 

state file test 

When you enter a DLBL command specifying only a ddname and mode, as 
follows : 

dlbl junk a 

CMS assigns a file identifier of FILE JUNK A1 to the ddname JUNK. 

4. The FILEDEF command performs a function similar to that of the DLBL 
command; you need to use the FILEDEF command in CMS/DOS only: 

• When you want to override a default ddname for an assembler 
input or output file. 

• When you want to use the MOVEFILE command to process a file. 

5. If you use the DUMMY operand, you must have issued an ASSGN command 
specifying a device type of IGN, or ignore, for the SYSxxx unit 
specified in the DLBL command, for example, 

assgn sys003 ign 

dlbl test dummy (sys003 

SPECIFYING VSAM EXTENT INFORMATION: You must specify extent information 
when you use the Access Method Services control statements DEFINE SPACE, 
DEFINE MASTERCATALOG, DEFINE USERCATALOG, DEFINE CLUSTER (UNIQUE) ; or 
when you use the IMPORT or IMPORTRA functions for a unigue file. 

When you enter the EXTENT option of the DLBL command, you are 
prompted to enter the disk extents for the specified file. You must 
enter extent information in accordance with the following rules: 

• You must specify the starting track number and number of tracks for 
each extent, as follows: 

19 38 
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This extent allocates 38 tracks , beginning with the 19th track, on a 
3330 device. 

• All extents must begin and end on cylinder boundaries, regardless of 
whether the AMSERV file contains extent information in terms of 
cylinders, tracks, or records. 

• Multiple extents for the same volume must be entered in numerically 
ascending order, for example 

20 400, 600 80 

These extents are valid for a 2314 device. 

• Multiple extent entries may be entered on a single line, separated by 
commas (as above) , or on different lines. Commas at the end of a line 
are ignored. 

• The maximum track value for starting or ending track is 2147483647. 

• when you enter multivolume extents, you must specify the mode letter 
and logical unit associated with each disk that contains extents; 
extents for each disk must be entered consecutively. For example, 

assgn sys001 b 
assgn sys002 c 
assgn sys003 d 
dlbl filel b (extent sys001 
DMSDLB331R ENTER EXTENT SPECIFICATIONS: 
100 60, 400 80, 60 40 d sys003 
200 100 c sys002 
400 100 c sys002 
(null line) 

specifies extents on disks accessed at modes B, C, and D. These 
disks are assigned to the logical units SYS001, SYS002, and SYS003. 
Since B is the mode specified on the DLBL command line, it does not 
need to be respecified along with the extent information. 

• A DASD volume must be mounted, accessed, and assigned for each disk 
mode referenced in an extent. 

When you are finished entering extent information, you must enter a 
null line to terminate the DLBL command seguence. If you do not, an 
error may result and you will have to reenter the DLBL command. If you 
make any error entering the extents, you must reenter all the extent 
information. 

The DLBL command does not check the extents to see if they are on 
cylinder boundaries or that they are entered in the proper seguence. If 
you do not enter them correctly, the Access Method Services DEFINE 
function will terminate with an error. 

CMS assigns seguence numbers to the extents according to the order in 
which they were entered. These seguence numbers are listed when you use 
| the LISTDS command with the EXTENT option. 

I IDENTIIXIMG IHITIVOLOME VSAM IXTEJT.S: When you want to execute a program 

| or use Access Method Services to reference an existing multivolume VSAM 

I data set, you must use the MULT option on the DLBL command that 

I identifies the file. 

I When you use the MULT option, you are prompted to enter additional 
| disk mode letters, as follows: 
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assgn sysOOl c 

assgn sys002 d 

assgn sys003 e 

assgn sys004 f 

assgn sys005 g 

dlbl infile c (mult sysOOl 

DMSDLB330H ENTER VOLUME SPECIFICATIONS: 

d sys002, e sys003 , f sysOOU 

g sys005 

(null line) 

The above identifies a file that has extents on disks accessed at modes 
C, D, E, F, and G. These disks have been assigned to the logical units 
SYS001, SYS002, SYS003, SYS004 , and SYS005. The rules for entering 
multiple extents are: 

• All disks must be mounted, accessed, and assigned when you issue the 
DLBL command. 

• You must not repeat the mode letter and logical unit of the disk that 
is entered on the DLBL command line (C, in the above example) . 

• If you enter more than one mode letter and logical unit on a line, 
they must be separated by commas; trailing commas on a line are 
ignored. 

• A maximum of nine disks may be specified; you do not need to specify 
them in alphabetical order. 

You must enter a null line to terminate the command when you are 
finished entering extents; if not, an error may result and you must 
reenter the entire command seguence. 

USING VSAM CATALOGS: There are two special ddnames you must use to 
identify a VSAM master catalog and job catalog: 

IJSYSCT identifies the master catalog when you initially define it 
(using AMSERV) , and when you begin a terminal session. You 
should use the PERM option when you define it. 

You must assign the logical unit SYSCAT to the disk on which 

the master catalog resides. If you are redefining a master 

catalog that has already been identified, you may omit the 
SYSCAT option on the DLBL command line. 

IJSYSUC identifies a job catalog to be used for subseguent AMSERV jobs 
or VSAM programs. 

Any programmer logical unit may be used to assign a job 
catalog. 

Only one VSAM catalog is ever searched when a VSAM function is 
performed. If a job catalog is defined, you may override it by using 
the CAT option on the DLBL command for a data set. The following DLBL 
command seguence illustrates the use of catalogs: 

assgn syscat c 

dlbl ijsysct c dsn mastcat (perm syscat 

identifies the master catalog, MASTCAT, for the terminal session. 

assgn sys010 d 

dlbl ijsysuc d dsn mycat (perm sys010 
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| identifies the job (user) catalog, MYCAT, for the terminal session. 

assgn syslOO e 

dlbl intestl e dsn test case (vsam syslOO 

identifies a VSAM file to be used in a program. It is cataloged in the 
job catalog, MYCAT. 

assgn sys101 f 

dlbl cat3 f dsn testcat (cat ijsysct sys101 

identifies an additional user catalog, which has an entry in the master 
catalog. Since a job catalog is in use, you must use the CAT option to 
indicate that another catalog, in this case the master catalog, should 
be used. 

dlbl infile f dsn test input (cat cat3 sys101 

identifies an input file cataloged in the user catalog TESTCAT, which 
was identified with a ddname of CAT3 on the DLBL command. 

The selection of a VSAM catalog for AMSERV jobs and VSAM programs 
running in CMS is summarized in Figure 6. 
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I Figure 6. Determining Which VSAM Catalog to Use 



74 IBM VM/370: CMS Command and Macro Reference 



DLBL 

I U§ajge Notes for OS VSAM Users 

1. You must use the DLBL command to identify all Access Method 
Services input and output files, and to identify all VSAM input and 
output files referenced in programs. 

For all other file definitions, including OS or CMS disk files 
referenced in programs that use VSAM data management, you must use 
the FILEDEF command. 

2. A DLBL ddname may have a maximum of 7 characters. If you have 
ddnames in your programs that are 8 characters long, only the first 
7 characters are processed when the programs are executed in CMS. 
If you have two ddnames with the same first 7 characters and you 
attempt to execute this program in CMS, you will receive an open 
error when the second file is opened. You should recompile these 
programs providing unigue 7-character ddnames. 

3. If you release a disk for which you have a DLBL definition in 
effect, you should clear the DLBL definition before you execute a 
VSAM program or an AMSERV command. CMS checks that all disks for 
which there are DLBL definitions are accessed, and issues error 
message DMSSTT069E if any are not. 

SPECIFYING VSAM EXTENT INFORMATION: You must specify extent information 
when you use the Access Method Services control statements DEFINE SPACE, 
DEFINE MASTERCATALOG, DEFINE USERCATALOG, DEFINE CLUSTER (UNIQUE) ; or 
when you use the IMPORT or IMPORTRA functions for a unigue file. Space 
allocation is made only for primary allocation amounts. 

When you enter the EXTENT option of the DLBL command, you are 
prompted to enter the disk extents for the specified file. You must 
enter extent information in accordance with the following rules: 

• You must specify the starting track number and number of tracks for 
each extent, as follows: 

19 38 

This extent allocates 38 tracks, beginning with the 19th track, on a 
3330 device. 

• All extents must begin and end on cylinder boundaries, regardless of 
whether the AMSERV file contains extent information in terms of 
cylinders, tracks, or records. 

• Multiple extents for the same volume must be entered in numerically 
ascending order, for example 

20 400, 600 80 
These extents are valid for a 2314 device. 

• Multiple extent entries may be entered on a single line, separated by 
commas (as above) , or on different lines. Commas at the end of a line 
are ignored. 

• The maximum track value for starting or ending track is 2147483647. 

• When you enter multivolume extents, you must specify the mode letter 
for extents on additional disks; extents for each disk must be 
entered consecutively. For example, 
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| dlbl filel b (extent 

| DMSDLB331R ENTER EXTENT SPECIFICATIONS: 

| 100 60, 400 80, 60 40 d 

| 200 100 c 

I 400 100 c 

| (null line) 

J specifies extents on disks accessed at modes B, C, and D. Since B is 

| the mode specified on the DLBL command line, it does not need to be 

| respecified along with the extent information. 

| • A DASD volume must be mounted and accessed for each mode referenced 

| in an extent. 

| When you are finished entering extent information, you must enter a 

| null line to terminate the DLBL command sequence. If you do not, an 

| error may result and you will have to reenter the entire DLBL command. 

| If you make any error entering the extents, you must reenter all the 

| extent information. 

| The DLBL command does not check the extents to see if they are on 

| cylinder boundaries or that they are entered in the proper sequence. If 

| you do not enter them correctly, the Access Method Services DEFINE 

| function terminates with an error. 

| CMS assigns sequence numbers to the extents according to the order in 

i which they were entered. These sequence numbers are listed when you use 

| the LISTDS command with the EXTENT option. 

I IDENTIFYING MULTIVOLUME VSAM EXTENTS: When you want to execute a program 

| or use Access Method Services to reference an existing multivolume VSAM 

| data set, you must use the MULT option on the DLBL command that 

| identifies the file. 

| When you use the MULT option, you are prompted to enter additional 

| disk mode letters, as follows: 

| dlbl infile c (mult 

| DMSDLB330R ENTER VOLUME SPECIFICATIONS: 

I d, e, f 

I g 

I (null line) 

| The above example identifies a file that has extents on disks accessed 

| at modes C, D, E, F, and G. The rules for entering multiple extents are: 

| • All disks must be mounted and accessed when you issue the DLBL 

| command. 

| • You must not repeat the mode letter of the disk that is entered on 

I the DLBL command line (C, in the above example) . 

I • If you enter more than one mode letter on a line, they must be 

j separated by commas; trailing commas on a line are ignored. 

| • A maximum of nine disks may be specified; you do not need to specify 

| them in alphabetical order. 

| You must enter a null line to terminate the command when you are 

J finished entering extents; if not, an error may result and you must 

| re-enter the entire command sequence. 
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USING VSAM CATALOGS: There are two special ddnames you must use to 
identify a VSAM master catalog and job catalog: 

IJSYSCT identifies the master catalog, both when you initially define 
it (using AMSERV) , and when you begin a terminal session. You 
should use the PERM option when you define it. 

IJSYSUC identifies a job catalog to be used for subseguent AMSERV jobs 
or VSAM programs. 

Only one VSAM catalog is ever searched when a VSAM function is 
performed. If a job catalog is defined, you may override it by using 
the CAT option on the DLBL command for a data set. The following DLBL 
command seguence illustrates the use of catalogs: 

dlbl ijsysct c dsn mastcat (perm 
identifies the master catalog, MASTCAT, for the terminal session. 

dlbl ijsysuc d dsn mycat (perm 
identifies the job (user) catalog, MYCAT, for the terminal session. 

dlbl intestl e dsn test case (vsam 

identifies a VSAM file to be used in a program. It is cataloged in the 
job catalog, MYCAT. 

dlbl cat3 dsn testcat (cat ijsysct 

identifies an additional user catalog, which has an entry in the master 
catalog. Since a job catalog is in use, you must use the CAT option to 
indicate that another catalog, in this case the master catalog, should 
be used. 

dlbl infile e dsn test input (cat cat3 

identifies an input file cataloged in the user catalog TESTCAT, which 
was identified with a ddname of CAT3 on the DLBL command. 

The selection of a VSAM catalog for AMSERV jobs and VSAM programs 
running in CMS is summarized in Figure 6. 

Responses 

If the DLBL command is issued with no operands, the current DLBL 
definitions are displayed at your terminal: 

ddnamel devicel [fn1 ft1 fm1 [datasetnamel ]] 



ddnamen devicen [ fnn ftn fmn [ datasetnamen ] ] 

DMSDLB220R ENTER DATA SET NAME: 

This message is displayed when you use the DSN ? form of the DLBL 
command. Enter the exact DOS or OS data set name. 

DMSDLB320I MAXIMUM NUMBER OF DISK ENTRIES RECORDED 

This message indicates that nine volumes have been specified for a 
VSAM data set, which is the maximum allowed under CMS. 
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| DMSDLB321I MAXIMUM NUMBER OF EXTENTS RECORDED 

This message indicates that 16 extents on a single disk or minidisk 
have been specified for a VSAM data space, catalog, or unique data 
set. This is the maximum number of extents allowed on a minidisk 
or disk. 

DMSDLB322I DDNAME 'ddname' NOT FOUND; NO CLEAR EXECUTED 

This message indicates that the clear function was not performed 
because no DLBL definition is in effect for the ddname. 

DMSDLB232I { MASTER | JOB} CATALOG DLBL CLEARED 

This message indicates that either the master catalog or job 
catalog has been cleared as a result of a clear request. 

You also receive this message if you issue a DLBL * CLEAR command, 
and any DLBL definition is in effect for IJSYSCT or IJSYSUC that 
was not entered with the PERM option. 

DMSDLB330R ENTER VOLUME SPECIFICATIONS: 

This message prompts you to enter volume specifications for 
existing multivolume VSAM files. (See "Identifying Multivolume VSAM 
Extents" in the appropriate usage section.) 

DMSDLB331R ENTER EXTENT SPECIFICATIONS: 

This message prompts you to enter in the data set extent or extents 
of a new VSAM data space, catalog or unique data set. (See 
"Specifying VSAM Extent Information" in the appropriate usage 
j section.) 

I Other Messages and Return Codes 

DMSDLB001E HO FILENAME SPECIFIED, RC=24 
DMSDLB003E INVALID OPTION 'option' RC=24 
DMSDLB005E NO • { CAT | BUFSP }' SPECIFIED RC=24 
DMSDLB023E NO FILETYPE SPECIFIED, RC=24 
DMSDLB048E INVALID MODE 'mode' RC=2U 
DMSDLB050E PARAMETER MISSING AFTER DDNAME RC=24 
DMSD1B065E 'option' OPTION SPECIFIED TWICE RC=24 
DMSDLB066E 'option' AND 'option' ARE CONFLICTING OPTIONS RC=24 
DMSDLB070E INVALID PARAMETER 'parameter' RC=2U 
DMSDLB086E INVALID DDNAME 'ddname' RC=2U 
DMSDLB109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
DMSDLB221E INVALID DATA SET NAME RC=24 

DMSDLB301E 'SYSxxx' NOT ASSIGNED FOR DISK «fm' RC=36 
DMSDLB302E NO SYSXXX OPERAND ENTERED RC=24 
DMSDLB30UE INVALID OPERAND VALUE 'value' RC=24 
DMSDLB305E INCOMPLETE EXTENT RANGE RC=24 
DMSDLB306E SYSXXX NOT ASSIGNED FOR 'IGNORE' RC=36 
DMSDLB307E CATALOG DDNAME 'ddname' NOT FOUND RC=24 

DMSDLB308E 'mode' DISK IN { CMS |NON-CMS } FORMAT; INVALID FOR 
{NON-CMS|CMS} DATASET RC=24 
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I DOSLIB 



Use the DOSLIB command to delete, compact, or list information about the 
executable phases in a CHS/DOS phase library. The format of the DOSLIB 
command is: 



DOSLIB 



DEL libname phasenamel [ . . . phasenamen ] 

COMP libname 

MAP libname [ (options. ..[ ) ]] 

op ti ons : 

r t 

| TERN | 
I DISK | 
| PRINT | 

L J 



I 

where : 
DEL 

COMP 
MAP 

libname 



deletes phases from a CMS/DOS phase library. The library is 
not erased when the last phase is deleted from the library. 

compacts a CMS/DOS phase library. 

lists certain information about the phases of a DOSLIB. 
Available information provided is phase name, size, and 
relative location in the library. 

is the filename of a CMS/DOS phase library. The filetype must 
be DOSLIB. 



phasenamel . . . phasenamen 

is the name of one or more phases that exist in the CMS/DOS 
phase library. 

HkE 0Eii2E§: The following options specify the output device for the 
MAP function. If more than one option is specified, only the first 
option is used. 



TERM 



displays the MAP output at the terminal. 



DISK writes the MAP output to a CMS disk file with the file 

identifier of * libname MAP A5» . If a file with that name 

already exists, the old file is erased. 

PRINT spools the MAP output to the virtual printer. 



12:2.5*96 Notes 
1 



The CMS/DOS environment does not have to be active when you issue 
the DOSLIB command. 

Phases may only be added to a DOSLIB by the CMS/DOS linkage editor, 
as a result of the DOSLKED command. 

In order to fetch a program phase from a DOSLIB for execution, you 
must issue the GLOBAL command to identify the DOSLIB. When a FETCH 
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command or dynamic fetch from a program is issued, all current 
DOSLIBs are searched for the specified phases. 

4. If DOSLIBs are very large, or there are many of them to search, 
program execution is slowed down accordingly. To avoid excessive 
execution times, you should keep your DOSLIBs small, and issue a 
GLOBAL command specifying only those libraries that you need. 

Responses 

When you use the TERM option on the DOSLIB MAP command line, the 
following is displayed: 

PHASE INDEX BLOCKS 
name! loc size 



0.tli§£ Messages and Return Codes 

DMSDSL002E FILE • f n DOSLIB 1 NOT FOUND RC=28 

DMSDSL003E INVALID OPTION 'option 1 RC=24 

DMSDSL013W PHASE •phase' NOT FOUND IN LIBRARY ' f n DOSLIB fm' RC=4 

DMSDSL014E INVALID FUNCTION 'function' RC=2U 

DMSDSL037E DISK 'mode' IS READ/ONLY RC=36 

DMSDSL046E NO LIBRARY NAME SPECIFIED RC=24 

DMSDSL047E NO FUNCTION SPECIFIED RC=2H 

DMSDSL069E DISK 'mode' NOT ACCESSED RC=36 

DMSDSL070E INVALID PARAMETER 'parameter' RC=24 

DMSDSL098E NO PHASE NAME SPECIFIED RC=24 

DMSDSL104S ERROR «nn' READING FILE • f n DOSLIB fm' FROM DISK RC=100 

DMSDSL105S ERROR • nn • WRITING FILE 'fn DOSLIB f m • ON DISK RC=100 

DMSDSL213W LIBRARY • f n DOSLIB fm» NOT CREATED RC = 4 
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I DOSLKED 



Use the DOSLKED command in CMS/DOS to link-edit TEXT files from CMS 
disks or object modules from DOS/VS private or system relocatable 
libraries and place them in executable form in a CMS phase library 
(DOSLIB) . The format of the DOSLKED command is: 



r i 

DOSLKED | fn |libname| [ (options, 

L J 

opt io ns i 



[) ]] 



r t 

| DISK | 
| PRINT | 
| TERM | 

L J 



I 



where : 
fn 



module to be 



specifies the name of the source file or 
link-edited. CMS searches for: 

1. A CMS file with a filetype of DOSLNK. 

2. A module in a private relocatable library (if IJSYSRL has 
been defined) . 

3. A CMS file with a filetype of TEXT. 

4. A module in the system relocatable library (if a mode was 
specified on the SET DOS ON command line) . 

libname designates the name of the DOSLIB where the link-edited phase 
is to be written. The filetype is DOSLIB. If libname is not 
specified, the default is fn. The output filemode of the 
DOSLIB is determined as follows: 

• If libname DOSLIB exists on a read/write disk, that 
filemode is used and the output is appended to it. 

• If fn DOSLNK exists on a read/write disk, libname DOSLIB is 
written to that disk. 

• If fn DOSLNK exists on a read-only extension of a 
read/write disk, libname DOSLIB is written to the parent 
disk. 

• If none of the above apply, libname DOSLIB is written to 
your A-disk. 

Options: Only one of the following options should be specified. If 
more than one is specified, only the first one is used. 

DISK writes the DOS/VS linkage editor map produced by the DOSLKED 
command on your A-disk into a file with the filename of fn and 
a filetype of MAP. This is the default option. 

PRINT spools the linkage editor map to the virtual printer. 
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TERM displays the linkage editor map at your terminal. 

Note: All error messages are sent to the terminal as well as to the 
specified device. 

Usage Notes 

1. You can create a CMS file with a filetype of DOSLNK to contain 
DOS/VS linkage editor control statements, and optionally, CMS text 
files. 

2. If you want to link-edit a module from a private relocatable 
library, you must issue an ASSGN command for the logical unit 
SYSRLB and enter a DLBL command using a ddname of IJSYSRL to 
identify the library: 

assgn sysrlb c 

dlbl ijsysrl c dsn reloc lib (sysrlb 

If you have defined a private relocatable library, but do not want 
it to be searched, enter 

assgn sysrlb ign 

to temporarily bypass it. 

3. CMS TEXT files may also contain linkage editor control statements 
INCLUDE, PHASE, and ENTRY. The ACTION statement is ignored when a 
TEXT file is link-edited. 

4. To access modules on the DOS/VS system residence volume, you must 
have specified the mode letter of the system residence on the SET 
DOS ON command line: 

set dos on z 

5. The search order that CMS uses to locate object modules to be 
link-edited is: 

a. The specified object module on the DOS/VS private relocatable 
library, if one is available. 

b. CMS disks for a file with the specified filename and with a 
filetype of TEXT. 

c. The specified object module on the DOS/VS system relocatable 
library, if it is available. 

6. When a phase is added to an existing DOSLIB, it is always written 
at the end of the library. If a phase that is being added has the 
same name as an existing phase, the DOSLIB directory is updated to 
point to the new phase. The old phase is not deleted, however; you 
should issue the DOSLIB command with the COMP option to compress 
the space. 

If you run out of space in a DOSLIB while you are executing the 
DOSLKED command, you should reissue the DOSLKED command specifying 
a different DOSLIB, or compress the DOSLIB before attempting to 
reissue the DOSLKED command. 

LIN.OGE EDITOR CONTROL STATEMENTS: The CMS/DOS linkage editor recognizes 
and supports the DOS/VS linkage editor control statements ACTION, PHASE, 
ENTRY, and INCLUDE. These control statements are described in DOS/VS 
System Control Statements. The CMS/DOS linkage editor ignores: 
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• The SVA operand of the PHASE statement. 

• The F+address form for specifying origin on the PHASE statement. 

• The BG, F1, F2, F3, or FU operands of the ACTION statement. 

The S-form of specifying the origin on the PHASE statement corresponds 
to the CMS user area under CMS/DOS. If a default PHASE statement is 
required, the origin is assumed to be S. The PBDY operand of the PHASE 
statement indicates that the phase is link-edited on a UK page boundary 
under CMS/DOS as opposed to a 2K page boundary for DOS/VS. 

In DOS/VS , an ACTION CLEAR control statement clears the unused 
portion of the core image library to binary zeros. In DOS/VS the core 
image library has a defined size, while in CMS/DOS the CMS phase library 
varies in size, depending on the number of phases cataloged. Therefore, 
in CMS/DOS an ACTION CLEAR control statement clears the current buffers 
to binary zeros before loading them; CMS/DOS cannot clear the entire 
unused portion of the CMS phase library because that portion varies as 
phases are added to and deleted from the CMS phase library. In CMS/DOS 
if you want your phases cleared you must issue an ACTION CLEAR control 
statement each time you add a phase to the CMS phase library. 

LINKAGE I5IJ0.I CARD TYPES: The input to the linkage editor can consist 
of six card types, produced by a language translator or a programmer. 
These cards appear in the following order: 

Card Type definition 

ESD External symbol dictionary 

SYM Ignored by linkage editor 

TXT Text 

RLD Relocation list dictionary 

REP Replacement of text made by the programmer 

END End of module 

CMS/DOS supports these six card types in the same manner that DOS/VS 
does. These card types are described in the DOS/VS System Control 
St at em en ts . 

Responses 

When you use the TERM option of the DOSLKED command, the linkage editor 
map is displayed at the terminal. 

21011 INVALID OPERATION IN CONTROL STATEMENT 

This message indicates that a blank card was encountered in the 
process of link-editing a relocatable module. This message also 
appears in the MAP file. The invalid card is ignored and 
processing continues. 

Other Messages and Return Codes 

DMSDLK001E NO FILENAME SPECIFIED RC=24 

DMSDLK003E INVALID OPTION 'option 1 RC=24 

DMSDLK006E NO READ/WRITE DISK ACCESSED RC=36 

DMSDLK007E FILE 'fn ft fm» IS NOT FIXED, 80-CHAR. RECORDS RC=32 

DMSDLK070E INVALID PARAMETER 'parameter 1 RC=24 

DMSDLK099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSDLK104S ERROR ' nn • READING FILE • f n ft fm« FROM DISK RC=100 

DMSDLK105S ERROR • nn • WRITING FILE «fn ft f m • ON DISK RC=100 

DMSDLK210E LIBRARY 'library 1 IS ON READ-ONLY DISK RC=36 

DMSDLK2U5S ERROR 'nnn« ON PRINTER RC=100 
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Use the DSERV command in CMS/DOS to obtain information that is contained 
in DOS/VS private or system libraries. The format of the DSERV command 
is: 



I 

| DSERV 



| (phasename \ |nn| | 

CD | PHASE I phasename J | J. 2 1 | / [d2 ...dn] [ (options[) ]] 



RD 
SD 
PD 
TD 
ALL 



o£ t i o n s : 



| DISK | 
| TERM | 
| PRINT | 

L J 

[SORT] 



where : 

CD 
RD 
SD 
PD 
TD 
ALL 



specifies that information concerning one or more types of 
directories is to be displayed or printed. The directory 
types that can be specified are: CD (core image library), 
RD (relocatable library) , SD (source statement- library) , 
PD (procedure library) , TD (transient directory) , and 
ALL (all directories) . 

There is no default value. The private libraries take 
precedence over system libraries. 

PHASE phasename 

specifies the name of the phase to be listed. If the 
phasename ends with an asterisk, all phases that start with 
the letters preceding the asterisk are listed. This operand 
is only valid for CD. 



nn 



is the offset within the phase where the version and level 
are to be found (the default is 12) . 



[d2...dn] indicates additional libraries whose directories are to be 
listed. (See Usage Note 1.) 

pj) t io n s : 

PJ : SK writes the output on your CMS A-disk to a file named DSERV MAP 
A5. This is the default value if TERM or PRINT is not 
specified. 

TERM displays the output at your terminal. 

PRINT spools the output to the system printer. 

SORT sorts the entries for each library alphamerically; otherwise, 
the order is the order in which the entries were cataloged. 

nsa<je Notes 

1. You may specify more than one directory on DSERV command line, for 
example. 
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dserv rd sd cd phase $$bopen (term 

displays the directories of the relocatable and source statement 
libraries, as well as the entry for the phase $$BOPEN from the core 
image directory. 

You can specify only one phasename or phasename* at a time, 
however. If you specify more than one PHASE operand, only the last 
one entered is listed. For example, if you enter 

dserv cd phase cor* phase idc* 

the file DSERV MAP contains a list of all phases that begin with 
the characters IDC. The first phasename specification is ignored. 

2. If you want to obtain information from the directories of private 
source statement, relocatable, or core image libraries, the 
libraries must be assigned and identified (via ASSGN and DLBL 
commands) when the DSERV command is issued. Otherwise, the system 
library directories are used. System directories are made 
available when you specify a mode letter on the SET DOS ON command 
line. 

3. The current assignments for logical units are ignored by the DSERV 
command; output is directed only to the output device indicated by 
the option list. 

Responses 

When you use the TERM option of the DSERV command, the contents of the 
specified directory are displayed at your terminal. 

01k§£ H®§§ages and Return Codes 

DMSDSV003E INVALID OPTION 'option* RC=24 

DMSDSV021W NO TRANSIENT DIRECTORY RC=4 

DMSDSV022W NO CORE IMAGE DIRECTORY RC=4 

DMSDSV023W NO RELOCATABLE DIRECTORY RC=4 

DMSDSV024W NO PROCEDURE DIRECTORY RC=4 

DMSDSV025W NO SOURCE STATEMENT DIRECTORY RC=4 

DMSDSV026W 'phase' NOT IN LIBRARY RC=4 

DMSDSV027E INVALID DEVICE »nn» RC=24 

DMSDSV027W NO PRIVATE CORE IMAGE LIBRARY RC=4 

DMSDSV028W NO { PRIVATE | SYSTEM } TRANSIENT DIRECTORY ENTRIES RC=4 

DMSDSV047E NO FUNCTION SPECIFIED RC=24 

DMSDSV065E 'option 1 OPTION SPECIFIED TWICE RC=24 

DMSDSV066E 'option' AND 'option' ARE CONFLICTING OPTIONS RC=24 

DMSDSV070E INVALID PARAMETER 'parameter' RC=24 

DMSDSV095E INVALID ADDRESS 'address' RC=24 

DMSDSV099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSDSV105S ERROR »nn' WRITING FILE 'DSERV MAP A5' ON DISK RC=24 

DMSDSV245S ERROR 'nnn» ON PRINTER RC=100 
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Use the EDIT command to invoke the CMS Editor to create, modify, and 
manipulate CMS disk files. Once the editor has been invoked, you may 
only execute EDIT subcommands and edit macro requests, and input data 
lines into the disk file. A limited number of CMS commands may be 
executed in the CMS subset mode, entered from the edit environment. 



You can return control to 
subcommands FILE or QUIT. 



the CMS environment by issuing the EDIT 



For complete details on the EDIT subcommand formats and usage, see 
"Section 3. EDIT Subcommands and Macros." For tutorial information on 
using the CMS Editor, including examples, see the VM^370: CMS UserJ|.s 
Guide. The format of the EDIT command is: 



Edit 



fn ft [fm] 
* 



[ (options. . .[) ]] 

opt i ons : 
[LRECL nn] 
[NODISP] 



where : 
fn ft 



is the filename and filetype of the file to be created or 
edited. If a file with the specified filename and filetype 
does not exist, the CMS Editor assumes that you want to create 
a new file, and after you issue the INPUT subcommand, all data 
lines you entered become input to the file. If a file with 
the specified filename and filetype exists, you may issue EDIT 
subcommands to modify the specified file. 



fm 



is the filemode of the file to be edited, indicating the disk 
on which the file resides. The editor determines the filemode 
of the edited file as follows: 



Editing existing file-§: If the file does not reside on your 
A-disk or it extensions, you must specify fm. 

When you specify fm, the specified disk and its extensions are 
searched. If a file is found on a read-only extension, the 
filemode of the parent disk is saved; when you issue a FILE or 
SAVE subcommand, the modified file is written to the parent 
disk. 



If you specify fm as an asterisk (*) all accessed 
searched for the specified file. 



disks are 



Creatincj new files: If you do not specify fm, the new file is 
written on your A-disk when you issue the FILE or SAVE 
subcommands. 
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0£ t ion s : 

LRECL nn is the record length of the file to be created or edited. 
Use this option to override the default values supplied by 
the editor, which are determined as follows: 

I^iiiM Existing Files: Existing record length is kept 
regardless of format. If the file has variable-length 
records and the existing record length is less than the 
default record length, the default record length is used. 

Creating New Files: All new files have a record length of 
80, with the following exceptions: 

Fil etyjae LRECL 

LISTING 12l 

SCRIPT, VSBDATA 132 

FREEFORT 81 

The maximum record length supported by the editor is 160 
characters. 

NODISP forces a 3270 display terminal into line (typewriter) 
mode. When the NODISP option is in effect, all subcommands 
that control the display as a 3270 terminal such as SCROLL, 
SCROLLUP, and FORMAT (and CHANGE and with no operands) are 
made invalid for the edit session. 



Responses 
NEW FILE: 

The specified file does not exist. 



EDIT: 



The edit environment is entered. You may issue any valid EDIT 
subcommand or macro reguest. 



INPUT: 

The input environment is entered by issuing the EDIT subcommands 
REPLACE or INPUT with no operands. All subseguent input lines are 
accepted as input to the file. 

P.£JlisI Messages and Return Codes 

DMSEDI003E INVALID OPTION 'option' RC=2U 

| DMSEDI024E FILE 'EDIT CMSUT1 fm« ALREADY EXISTS RC=28 

DMSEDI029E INVALID PARAMETER •parameter' IN THE OPTION 'LRECL' FIELD RC=24 

DMSEDIOUUE RECORD LENGTH EXCEEDS ALLOWABLE MAXIMUM RC=32 

DMSEDI054E INCOMPLETE FILEID SPECIFIED RC=2U 

DMSEDI076E ACTUAL RECORD LENGTH EXCEEDS THAT SPECIFIED RC=40 

DMSEDI104S ERROR »nn' READING FILE ' f n ft fm' FROM DISK RC=100 

DMSEDI105S ERROR • nn • WRITING FILE • f n ft f m • ON DISK RC=100 

| DMSEDI117S ERROR WRITING TO DISPLAY TERMINAL RC=100 
DMSEDI132S FILE »fn ft fm» TOO LARGE RC=88 

| DMSEDI143S UNABLE TO LOAD SAVED SYSTEM OR LOAD MODULE RC=40 

| DMSEDI14US REQUESTED FILE IS IN ACTIVE STATUS 
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Use the ERASE command to delete one or more CMS files from a read/write 
disk. The format of the ERASE command is: 



fn ft [ f m ] [ (options. ..[)] ] 
* * 




ft 



fm 



opt i on s : 

r t 

| Type | 

L J 



is the filename of the f ile (s) to be erased. An asterisk coded 
in this position indicates that all filenames are to be used, 
fn must be specified, either with a name or an asterisk. 

is the filetype of the file(s) to be erased. An asterisk coded 
in this position indicates that all filetypes are to be used. 
This field must be specified, either with a name or an 
asterisk. 



is the filemode of the files to be erased 
omitted, only the A-disk is searched. 



If this field is 



Op tion s : 



TYPE displays at the terminal the file identifier of each file 
erased. 

I^TYPE file identifiers are not displayed at the terminal. 

Usage Notes 

1. If you specify an asterisk for both filename and filetype you must 
specify both a filemode letter and number, for example, 

erase * * a5 

To erase all files on a particular disk, you can use the FORMAT 
command to reformat it or access the disk using the ACCESS command 
with the ERASE option. 

Responses 

If you specify the TYPE option, the file identification of each file 
erased is displayed For example, 

erase oldfile temp (type 

results in the display: 

OLDFILE TEMP A1 

R; 
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Other Messages and Return Codes 

DMSERS002E FILE [»fn [ft [fm]]« ] NOT FOUND RC=28 
DMSERS003E INVALID OPTION 'option 1 RC=24 
DMSERS037E DISK •mode' IS READ/ONLY RC=36 
DMSERS0U8E INVALID MODE 'mode 1 RC=2U 
DMSERS054E INCOMPLETE FILEID SPECIFIED RC=24 
DMSERS069E DISK 'mode 1 NOT ACCESSED RC=36 
DMSERS070E INVALID PARAMETER 'parameter* RC=2U 
DMSERS071E ERASE * * [*|mode] NOT ALLOWED RC=24 
DMSERS109T VIRTUAL STORAGE CAPACITY EXCEEDED 

UPJi.§ : You can invoke the ERASE command from the terminal, from an EXEC 
file, or as a function from a program. If ERASE is invoked as a function 
or from an EXEC file that has the SCONTROL NOMSG option in effect, the 
DMSERS002E FILE fn ft fm NOT FOUND error message is not issued. 
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I ESERV 



Use the ESERV EXEC procedure in CMS/DOS to copy edited DOS/VS macros 
from system or private source statement E sublibraries to CMS disk 
files, or to list de-edited macros. The format of the ESERV command is: 



r - 

| ESERV | fn 



where: 



fn specifies the filename of the CMS file that contains the ESERV 
control statements; it must have a filetype of ESERV. The logical 
unit SYSIPT must be assigned to the disk on which the ESERV file 
resides. fn is also the filename of the LISTING and MACRO files 
produced by the ESERV program. 

H s .§.9.§ M.2£§.5 

I. The input file can contain any or all of the ESERV control 
statements as defined in Guide to the DOS/VS Assembler. 

2. You must have a read/write A-disk accessed when you use the ESERV 
command. 

3. To copy macros from the system source statement library, you must 
have entered the CMS/DOS environment specifying the mode letter of 
the DOS/VS system residence. To copy from a private source 
statement library, you must assign the logical unit SYSSLB and 
issue a DLBL command for the ddname IJSYSSL. 

4. The output of the ESERV program is directed (as in DOS/VS) to 
devices assigned to the logical units SYSLST and/or SYSPCH. If 
either SYSLST or SYSPCH is not assigned, the following files are 
created : 

Ufiit QHtgut Iii§ 
SYSLST fn~LISTING mode 
SYSPCH fn MACRO mode 

where mode is the mode letter of the disk on which the source file, 
fn ESERV resides. If fn ESERV is on a read-only disk, the files are 
written to your A-disk. 

You can override default assignments made by the ESERV EXEC as 
follows : 

« If you assign SYSIPT to TAPE or READER, the source statements 
are read from that device. 

« If you assign SYSLST or SYSPCH to another device, the SYSLST or 
SYSPCH files are written to that device. 

5. The ESERV EXEC procedure clears all DLBL definitions, except those 
entered with the PERM option. 

| 6. If you want to use the ESERV command in an EXEC procedure, you must 
| use the EXEC command (because ESERV is also an EXEC) . 
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7. When you use the ESERV control statements PUNCH or DSPCH, the ESERV 
program may generate CATAL.S, END, or /* records in the output 
file. When you add a MACRO file containing these statements to a 
CMS macro library using the MACLIB command, the statements are 
ignored and are not read into the MACLIB member. 

Responses 

None. The CMS Ready message indicates that the ESERV program completed 
execution successfully. You may examine the SYSLST output to verify the 
results of the ESERV program execution. 

IE£2I Messages and Return Codes 

DMSERV001E NO FILENAME SPECIFIED RC=24 
DMSERV002E FILE »fn ESERV NOT FOUND RC=28 
DMSERV006E NO READ / WRITE DISK ACCESSED RC=36 
DMSERV027E INVALID DEVICE • device ■ FOR SYSxxx RC=28 
DMSERV037E DISK 'mode' IS READ ONLY RC=36 
DMSERV070E INVALID ARGUMENT ■ argument • RC=2U 
DMSERV099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

Note: The ESERV EXEC calls other CMS commands to perform certain 
functions, and so you may, on occasion, receive error messages that 
occur as a result of those commands. 

Non-CMS error messages produced by the DOS/VS ESERV program are 
described in the Guide to the DOS^VS Assembler. 
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Use the EXEC command to execute one or more CMS commands or EXEC control 
statements contained in a specified EXEC file. The format of the EXEC 
command is: 



| [EXec] | fn [args...] 

where : 

[EXec] indicates that the EXEC command may be omitted if you are 
executing the EXEC procedure from the CMS command environment 
and have not issued the command SET IMPEX OFF. 

fn is the filename of a file containing one or more CMS commands 
and/or EXEC control statements to be executed. The filetype of 
the file must be EXEC and the file can have either fixed- or 
variable- length records with a logical record length not 
exceeding 130 characters. EXEC files can be created with the 
EDIT command or by a user program. EXEC files created by the 
CMS Editor have, by default, variable-length, 80-character 
records. 

args are any arguments you wish to pass to the EXEC. The arguments 
are assigned to the special variables &1 through &30 in the 
order in which they appear in the argument list. 

"Section 5. EXEC Control Statements" contains complete descriptions 
of EXEC control statements, special variables, and built-in functions. 
For information on designing EXEC procedures and examples of control 
word usage, see the VM/370: CMS User^s Guide. 

Responses 

The amount of information displayed during the execution of an EXEC 
depends on the setting of the &CONTROL control statement, which by 
default displays all CMS commands, responses and error messages. In 
addition, it displays nonzero return codes from CMS in the format 

+++ R (nnnnn) ++ + 

where nnnnn is the return code from the CMS command. 

For details, see the description of the &CONTROL control statement in 
"Section 5. EXEC Control Statements." 

l!§ssages and Return Codes 

If the EXEC interpreter finds an error, it displays the message: 
| DMSEXT072E ERROR IN EXEC FILE filename, LINE nnnn - description 
The possible errors, and the associated return codes, are: 
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Return 

Description Code 

FILE NOT FOUND 80"T~ 

SSKIP OR &GOTO ERROR 802 

| BAD FILE FORMAT 803 

TOO MANY ARGUMENTS 804 
MAX DEPTH OF LOOP NESTING EXCEEDED 805 

| ERROR READING FILE 806 

INVALID SYNTAX 807 

INVALID FORM OF CONDITION 808 

INVALID ASSIGNMENT 809 

MISUSE OF SPECIAL VARIABLE 810 

ERROR IN &ERROR ACTION 811 

CONVERSION ERROR 812 

TOO MANY TOKENS IN STATEMENT 813 

MISUSE OF BUILT-IN FUNCTION 814 

EOF FOUND IN LOOP 815 

INVALID CONTROL WORD 816 

| EXEC ARITHMETIC UNDERFLOW 817 

| EXEC ARITHMETIC OVERFLOW 818 



Error Message and Return Code 
DMSEXC001E NO FILENAME SPECIFIED RC=24 
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I FETCH 



Use the FETCH command in CMS/DOS to load an executable phase into 
storage for execution. The format of the FETCH command is: 



phasename [ (options. . .[) ]] 



opti ons : 

[START] 

[COMP] 

[ORIGIN hexloc] 



where ,: 

phasename is the name of the phase to be loaded into virtual storage. 
CMS searches for the phase: 

1. In a DOS/VS private core image library, if IJSYSCL has 
been defined. 

2. In CMS DOSLIBs that have been identified with the GLOBAL 
command. 

3. In the DOS/VS system core image library, if you specified 
the mode letter of the DOS/VS system residence on the SET 
DOS ON command line. 

Option s : 

START specifies that once the phase is loaded into storage, 
execution should begin immediately. 

COMP specifies that when the phase is to be executed, register 1 
should contain the address of its entry point. (See Usage 
Note 4.) 

i ORIGIN hexloc 

I fetches the program and loads it at the location specified by 

I hexloc; this location must be in the CMS user area. The 

I location, hexloc, is a hexadecimal number of up to 8 

j characters. (See Usage Note 5.) 

I H§§3® Notes 

| 1. If you do not use the START option, FETCH displays a message at 

j your terminal indicating the name of the phase and the storage 

I location of its entry point. At this time you can set address 

I instruction stops for testing. To continue, issue the START 

| command to initiate execution of the phase just loaded. 

I 2. The fetch routine is also invoked by supervisor call (SVC) 
I instructions 1,2, 4, or 65. The search order for executable 
| phases is the same as listed above. 

I 3. If you want to fetch a phase from a private core image library, you 

I must issue an ASSGN command for the logical unit SYSCLB and define 

| the library in a DLBL command using the ddname IJSSYCL. For 

I example, 

I assgn sysclb c 

| dlbl ijsyscl c dsn core image lib (sysclb perm 
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4. CMS uses the COMP option when it fetches the DOS PL/I compiler 
because that compiler expects register 1 to contain its entry point 
address. This option is not required when you issue the FETCH 
command to load your own programs. 

When CMS starts executing a phase that has COMP specified, the 
DMSLI0740I EXECUTION BEGINS... message is not displayed. 

5. The ORIGIN option is used by the CMS/VSAM installation EXEC 
procedure to load nonshareable modules on a segment boundary. It 
is not required when you issue the FETCH command to load your own 
programs, unless you want to load them at a location other than 
20000. 

Responses 

DMSFET710I PHASE •phase 1 ENTRY POINT AT LOCATION xxxxxx 

This message is issued when the START option is not specified. It 
indicates the virtual storage address at which the phase was 
loaded. 

DMSLIO740I EXECUTION BEGINS... 

This message is issued when the START option is specified; it 
indicates that program execution has begun. 

Qther Messages and Return Codes 

DMSFCH104S ERROR 'nn» READING FILE • f n ft fm' FROM DISK RC=100 

DMSFCH109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSFCH113S DISK (cuu) NOT ATTACHED RC=100 

DMSFCH115E PHASE LOAD POINT LESS THAN 'address' RC=40 

DMSFCH411S INPUT ERROR CODE »nn » ON • { SYSRES | SYSCLB }• RC = 100 

DMSFCH777S DOS PARTITION TOO SMALL TO ACCOMMODATE FETCH REQUEST RC=104 

DMSFET003E INVALID OPTION 'option' RC=24 

DMSFET004E PHASE 'phase' NOT FOUND RC=28 

DMSFET029E INVALID PARAMETER 'parameter' IN THE OPTION 'ORIGIN' FIELD 

RC=24 
DMSFET070E INVALID PARAMETER 'parameter' RC=24 
DMSFET098E NO PHASE NAME SPECIFIED RC=24 
DMSFET099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 
DMSLIO055E NO ENTRY POINT DEFINED RC=40 
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Use the FILEDEF command to establish data definitions for OS ddnames, to 
define files to be copied with the MOVEFILE command, or to override 
default file definitions made by the assembler and the OS language 
processors. The format of the FILEDEF command is: 



Flledef 




[ (optionA optionD[) ]] 
[ (optionD[) ]] 



Terminal 

PRinter 

PUnch 

Reader 

r r m 

DISK |fn ft |fm|| [ (optionA optionB[) ]] 
l£IU£ <!££am.e. |A1 | | 

L L J J 



rr 

I | DISK f 

II FI 

LL 



DUMMY 

TAPn 

CLEAR 



n ft | |f m| | TDSN ? ) 

ILE dd name | | A 1. 1 | \ DSN guall gual2 ...j 



J L JJ 

[ (optionA optionB[) ]] 
[ (optionA[) ]] 
[ (optionA optionC[) ]] 



op t ion A : 
[PERM] 

r i 

| CHANGE | 
|NOCHANGE| 

L J 

[RECFM a] 
[LRECL nnnnn ] 

r 



op t i o nB : 
[ KEYLEN nnn ] 
r t 

IXTENT nnnnn | 
IXTENT 50 | 

L "" J 



[LIMCT nnn] 

[OPTCD a] 

[DISP MOD] 
| BLOCK nnnnn | [MEMBER membername] 
IBLKSIZE nnnnn | [CONCAT] 

L J 



opt ionC : 

r n 

|7TRACK| 
|9TRACK| 

L J 

[TRTCH a] 
[DEN den] 



opt i o nD : 

r t 

IUPCASE | 
|LOWCASE| 

L J 







where : 

ddname 
nn 



Devices 



is the name by which the file is referred to in your 
program. OS ddname syntax rules should be followed. If a 
number nn is specified, it is translated to a FORTRAN data 
definition name of FTnnFOOL An asterisk (*) may be specified 
with the CLEAR operand, to indicate that all file definitions 
not entered with the PERM option should be cleared. 



| TERMINAL is your terminal (terminal I/O must not be blocked) 
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PRINTER is the spooled printer 



PUNCH is the spooled punch. 



FILEDEF 



| READER is the spooled card reader (card reader I/O 
blocked) . 



mst not be 



DISK specifies that the virtual I/O device is a disk. As shown in 
the format, you can choose one of two forms for specifying the 
DISK operand. Both forms are described in "Using the FILEDEF 
DISK Operand." 



DUMMY 



indicates that no real I/O takes place for a data set. 



TAPn is a magnetic tape. The symbolic number of the tape drive, n r 
can be 1, 2, 3, or 1, representing virtual units 181, 182, 
183, and 184 respectively. 

CLEAR removes any existing definition for the specified ddname. 
Clearing a ddname before defining it ensures that a file 
definition does not exist and that any options previously 
defined with the ddname no longer have effect. 

O£tions: Whenever an invalid option is specified for a particular 
device type, an error message is issued. Figure 7 shows valid 
options for each device type. 





Unit 


Record 








Option 


READER, PUNCH 






DISK 




PRINTER 


TERMINAL 


TAPn 


DUMMY* 


BLOCK, BLKSIZE 




X 


X 


X 


1 x 


CHANGE, NOCHANGE 




X 


X 


X 


X 


CONCAT 










X 


DEN 








X 




DISP MOD 










X 


DSORG 










X 


KEYLEN 










| X* 


LIMCT 










X2 


LOWCASE, UPCASE 






X 






LRECL 




X 


X 


X 


X 


MEMBER 










X 


OPTCD 










X2 


PERM 




X 


X 


X 


X 


RECFM 




X 


X 


X 


X 


TRTCH 








X 3 




XTENT 










X2 


7TRACK, 9TRACK 








X 





*No options may be necessary but all disk options are accepted. 
2 This option is meaningful only for BDAM files. 
3 This option is for 7-track tapes only. 



Figure 7. Valid File Characteristics 
FILEDEF Command 



for Each Device Type of 



j 

the 
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PERM retains the current definition until it either is 
explicitly cleared or is changed with a new FILEDEF 
command with the CHANGE option. If PERM is not 
specified, the definition is cleared when a FILEDEF * 
CLEAR command is executed. 

CHANGE merges the file definitions whenever a file definition 
already exists for a ddname and a new FILEDEF command 
specifying the same ddname is issued; the options 
associated with the two definitions are merged. Options 
from the original definition remain in effect unless 
duplicated in the new definition. New options are added 
to the option list. 

NOCHANGE retains the current file definition, if one exists, for 
the specified ddname. 

RECFM a is the record format of the file, where 'a' can be one of 
the following: 

a 15§§SiE3 

F fixed length 

FB fixed blocked 1 

V variable length 

VB variable blocked 1 

U undefined 

FS,FBS fixed length, standard blocks 

VS,VBS variable length, spanned records 

A ASA print control characters 2 

M machine print control codes 2 

LRECL nnnnn is the logical record length (nnnnn) of the file, in 
bytes. LRECL should not exceed 32,767 bytes because of 
OS restrictions. 

BLOCK nnnnn 

BLKSIZE nnnnn 

is the logical block size (nnnnn) of the file, in bytes. 
BLOCK should not exceed 32,767 bytes because of OS 
restrictions. If both BLOCK and BLKSIZE options are 
specified, the value of nnnnn for BLOCK is used and 
BLKSIZE is ignored. 

If a CMS file is fixed and has 80-byte CMS records, you 
should specify RECFM FB BLOCK 800 LRECL 80 and a fileraode 
number of 1. (BLOCK can also be expressed as 80*10.) 
There can be significant performance improvement for CMS 
fixed files if the block size is a multiple of 800. 

KEYLEN nnn is the size (nnn) of the key (in bytes) . The maximum 
value accepted is 256. 

XTENT nnnnn is the number of records (nnnnn) in the extent for the 
file. The default is 50. The maximum value is 65535. 

LIMCT nnn is the maximum number of extra tracks or blocks (nnn) to 
be searched. The maximum value is 256. 



*FB and VB should not be used with TERMINAL or READER devices. 
2 A and M may be used in conjunction with any of the valid RECFM settings 
(for example, FA, FBA, VA, VBA, etc.) 
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OPTCD a is the direct access search processing desired. The 
variable •a' may be any combination of up to three of the 
following: (A and R are mutually exclusive.) 

Code DASD_Search 

A Actual device addressing 

E Extended search 

F Feedback addressing 

R Relative block addressing 

Note: The KEYLEN, XTENT, LIMCT, and OPTCD options should only be used 
with BDAM files. 

DISP MOD positions the read/write pointer after the last record in 
the disk file. 

MEMBER membername 

allows you to specify the name of a member of an OS 
partitioned data set; membername is the name of the PDS 
member. 

CONCAT allows you to assign the same ddname to two or more OS 
macro libraries so that you can refer to them in a single 
GLOBAL command. 



DSORG 




Any file format options you specify in the first FILEDEF 
command line remain in effect for subsequently 
concatenated libraries. 

is the data set organization: physical sequential (PS) , 
partitioned (PO) , direct access (DA) , or indexed 
sequential (IS) . 



r i 

| 7TRACK | is the tape setting 
| 9TRACK | 

L J 



TRTCH a 



is the tape recording technique for 7-track tapes. Use 



the following chart to determine the value of 
7-track tapes. 



for 



| Parity | Converter | Translator 



1 o 


odd 


off 


I oc 


odd 


on 


I OT 


odd 


I off 


1 E 


even 


off 


| ET 


even 


off 



off 

off 

on 

off 

on 



The default value of TRTCH is OC. 

DEN den is tape density: den can be 200, 556, 800, 1600, or 6250 

bpi (bits per inch). If 200 or 556 are specified, 7TRACK 

is assumed. If 800, 1600, or 6250 are specified 9TRACK is 
assumed. 

INCASE translates all terminal input data to uppercase. 

LOWCASE retains all terminal input data as typed in. 
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J2§»ac[e Notes 

1. If you do not issue a FILEDEF command for an OS input or output 
file, CMS uses the ddname on the DCB macro to issue the following 
default file definition: 

FILEDEF ddname DISK FILE ddname A1 

See "Usage Notes" under the discussion of the ASSEMBLE command for 
information on the default file definitions made by the assembler. 

2. To identify DOS files for DOS program execution, or to identify 
VSAM data sets for either OS or DOS program execution, you must use 
the DLBL command. 

3. A file definition established with the FILEDEF command remains in 
effect until explicitly changed or cleared. The system clears file 
definitions under the following circumstances: 

« When the assembler or any of the language processors are invoked 
(FILEDEF definitions entered with the PERM option are not 
cleared) . 

• When a program abends or when you issue the Immediate command HX 
to halt command or program execution. 

4. The FILEDEF command does not supply default values for LRECL and 
BLKSIZE. As under OS, if DCB information is unavailable when a 
file is opened, an open error is issued for the file. The 
following chart summarizes the results of specifying LRECL and 
BLKSIZE options. 

BLKSIZE | LRECL | Results 



i" 



Mot 
Specified 



Specified 



Not 
Specified 



Not |If the input file exists on disk, the item 
Specified | length becomes the BLKSIZE (or BLKSIZE + 4 
| for variable-length records). 

Not |LRECL=BLKSIZE (or LRECL=BLKSIZE-4 , for 
Specified | variable-length records). 



Specified | BLKSIZE=LRECL (or BLKSIZE=LRECL+4, for 
| variable-length records) . 



Specified | Specified |The values specified are used. 

If V or VB is specified for RECFM, LRECL must be at least 4 bytes 
less than BLKSIZE. 

DOS seguential (SAM) files do not contain BLKSIZE, LRECL, or RECFM 
specifications. These options must be specified by a FILEDEF 
command or DCB statement if OS macros are used to access DOS files. 
Otherwise the defaults, BLKSIZE=32760 and RECFM=U, are assumed. 
LRECL is not used for RECFM=U files. 

5. There is an auxiliary processing option for FILEDEF that is only 
valid when FILEDEF is executed by an internal program call: this 
option cannot be entered on a terminal command. The option, 
AUXPROC addr, allows an auxiliary processing routine to receive 
control during I/O operations. 
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Usincj the FILEDEF DISK Operand 

There are two general forms for specifying the DISK operand in a FILEDEF 
command. If you specify the first form: 

FILEDEF ddname DISK fn ft [ £m ] 

fn and ft (filename and filetype) are assumed to be a CMS fileid. If fm 
is the filemode of an OS disk, fn and ft are assumed to be the only two 
qualifiers of an OS data set name. 

You cannot use this form unless the OS data set name or DOS file-id 
conforms to the OS naming convention (1- to 8-byte qualifiers separated 
by periods, to a maximum of 44 characters, including periods) . Also, 
the data set name can have only two qualifiers; otherwise, you must use 
the DSN ? or DSN quail... form. For example, if the data set name or 
file-id is TEST. SAMPLE. MAY, you enter: 

FILEDEF MINE B1 DSN TEST SAMPLE MAY 

— or — 

FILEDEF MINE B1 DSN ? 
TEST. SAMPLE. MAY 

If the data set name or file-id is TEST. SAMPLE, then you may enter: 

FILEDEF MINE DISK TEST SAMPLE B1 

The second form of the DISK operand is used only with OS data sets 
and DOS files : 



FILEDEF ddname |DISK fn 



fn ft | |fm| / DSN ? \ 

HhM ddname | |A1.| \ DSN quail [qual2...]j 



This form allows you to to enter OS and DOS file identifications that do 
not conform to OS data set naming conventions. The DSN operand 
corresponds to the DSN parameter on the OS DD (data definition) 
statement. There are three ways you can specify this form: 

• FILEDEF ddname DISK fn ft fm DSN quail [qual2...] 

This form of the FILEDEF command associates the CMS filename and 
filetype you specify with the OS data set name or DOS file-id 
specified following the DSN operand. Once it is defined, you can 
refer to the OS data set name or DOS file-id by using the CMS 
filename and filetype. If you omit DISK, filename, filetype, and 
filemode, the default values are FILE ddname A1. 

• FILEDEF ddname DSN ? 

This form of the FILEDEF command allows you to specify the OS data 
set name or DOS file-id interactively. Using this form, you can 
enter an OS data set name or DOS file-id containing embedded special 
characters such as blanks and hyphens. If you use this form, the 
default filename and filetype for your file, FILE ddname, is the CMS 
filename and filetype associated with the OS data set name or DOS 
file-id. The filemode for this form is always the default, A1. 

To use the interactive DSN operand, you key in DSN ?; CMS then 
requests that you enter the OS data set name or DOS file-id exactly 
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as it appears in the data set or file. Do not omit the periods that 
separate the qualifiers of an OS data set name, but do not insert 
periods where they do not appear. 

qual1[ .qual2. . . ] 

where quail .qual2. . . are the qualifiers of the OS data set name or 
DOS file-id. When you use this form, you must code the periods 
separating the qualifiers. 

• FILEDEF ddname mode DSN quail [qual2...] 

This form allows you to specify the OS data set name or DOS file-id 
explicitly. (This form can be used for DOS file-ids only if they 
comply with the OS naming convention of 1- to 8-byte qualifiers 
separated by periods, to a maximum of 44 characters, including 
periods.) Again, the default value for the filename and filetype is 
FILE ddname. When you use this form, you must omit the periods that 
separate the qualifiers of the OS data set name. For example, for an 
OS data set or DOS file named MY. FILE. IN, you enter 

FILEDEF ddname B1 DSN MY FILE IN 

All of these forms have many variations, as is apparent from the 
command format. 

Kes£onses 

J ddnamel device 1 [filenamel filetypel filemodel [datasetname ]] 

J . . . • • • 

I . . . • . . 

J ddnameN deviceN [ f ilenameN filetypeN filemoden [datasetname]] 

| A list of current definitions is displayed if the FILEDEF command 
I is entered with no operands. 

| DMSFLD069I DISK •mode' NOT ACCESSED 

| The specified disk is not accessed; the file definition remains in 
| effect. You should access the disk before you attempt to read or 
| write the file. 

DMSFLD220R ENTER DATA SET NAME: 

A FILEDEF command with the DSN ? operand was entered. Enter the 
exact OS or DOS file identification, including embedded periods and 
blanks. 

DMSFLD704I INVALID CLEAR REQUEST 

A CLEAR request was entered for a file definition that does not 
exist; no action is taken. 

| DMSSTT228I USER LABELS BYPASSED ON DATA SET 'data set name' 

j This message is displayed when you issue a FILEDEF command for an 

| OS data set that contains user labels. The message is displayed the 

J first time you issue the FILEDEF command after accessing the disk 

I on which the data set resides. 
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l££2£ Messages and Return Codes 

DMSFLD003E INVALID OPTION 'option 1 RC=24 

DMSFLD023E NO FILETYPE SPECIFIED RC=24 

DMSFLD027E INVALID DEVICE 'device name' RC=2U 

DMSFLD029E INVALID PARAMETER 'parameter' IN THE OPTION 'option' FIELD 

RC = 24 
DMSFLD035E INVALID TAPE MODE RC=24 
DMSFLD050E PARAMETER MISSING AFTER DDNAME RC=24 
DMSFLD065E 'option' OPTION SPECIFIED TWICE RC=24 
DMSFLD066E 'option' AND 'option' ARE CONFLICTING OPTIONS RC=2<* 
DMSFLD070E INVALID PARAMETER 'parameter' RC=24 
DMSFLD221E INVALID DATA SET NAME 'data set name' RC=24 
DMSFLD224E FILEID ALREADY IN USE RC=2U 
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Use the FORMAT command to: 

• Initialize a virtual disk (minidisk) for use with CMS files 

• Count or reset the number of cylinders on a virtual disk. 

• Write a label on a virtual disk. 

The format of the FORMAT command is: 



FORMAT 



cuu mode [nocyl] [ (options. ..[) ]] 

0£t ions : 

r i 
| Label | 
| Recompl 

L J 



where : 

cuu is the virtual device address of the virtual disk to be 
formatted. 

| Valid addresses are 001 through 5FF for a virtual machine in 
| basic control mode and 001 through FFF for a virtual machine in 
| extended control mode. 

mode is the filemode letter to be assigned to the specified device 
address. Valid filemode letters are A, B, C r D, E, F r G, Y, and 
Z. This field must be specified. If any other disk is accessed 
at mode, it is released. 

nocyl is the number of cylinders to be made available for use. All 
available cylinders on the disk are used if the number specified 
exceeds the actual number available. 

OpJ: ion s : 

LABEL writes a label on the disk without formatting the disk. A 
6-character label is written on cylinder 0, track 0, record 3 
of the virtual disk. A prompting message requests a 
6-character disk label (fewer than 6 characters are 
left- justified and blank padded) . 

RECOMP changes the number of cylinders on the disk which are 
available to the user to the actual number of minidisk 
cylinders or to the number specified by nocyl, whichever is 
less. If nocyl is not specified, all cylinders are used. 

Usage Notes 

| 1. You can use the FORMAT command with any virtual 3330, 3340, 3350, 
or 2319 device. 

2. When you do not specify either the RECOMP or LABEL option, the disk 
area is initialized by writing a device— dependent number of records 
(containing binary zeros) on each track. Any previous data on the 
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disk is erased. A read after write check is made as the disk is 
formatted. For example, 

format 191 a 25 

initializes 25 cylinders of the disk located at virtual address 191 
in CMS format. The command 

format 192 b 25 (recomp) 

changes the number of cylinders available at virtual address 192 to 
25 cylinders, but does not erase any existing data. To change only 
the label on a disk, you can enter: 

format 193 c (label) 

Respond to the prompting message with a 6-character label. 

3. If you want to format a minidisk for VSAM files, you must use the 
IBCDASDI program. If you want to format an entire disk, you may 
use any OS or DOS disk initialization program. 

4. You should try not to use the FORMAT command when there are many 
users on the system; system performance may be degraded. 

Responses 

DMSFOR603R FORMAT WILL ERASE ALL FILES ON DISK 'mode (cuu) « . DO YOU WISH 
TO CONTINUE? (YES | NO): 

You have indicated that a disk area is to be initialized: all 
existing files are erased. This message gives you the option of 
canceling the execution of the FORMAT command. Reply yes or no. 

DMSFOR605R ENTER DISK LABEL: 

You have reguested that a label be written on the disk. Enter a 1- 
to 6-character label. 

DMSFCR705I DISK REMAINS UNCHANGED. 

The response to message, DMSFOR603R, was 'NO', or a null line was 
entered. 

DMSF0R732I »nnn« CYLINDERS FORMATTED ON DISK •mode(ccu)' 
The format operation is complete. 

DMSFOR733I FORMATTING DISK •mode 1 

The disk represented by mode letter 'mode' is being formatted. 

mode (cuu) : nnnn FILES, nnnnn REC IN USE, nnnnn LEFT (of nnnnn) , nn% 
FULL (nnn CYL) , type, R/W 

This message provides the status of a disk when you use the RECOMP 
option. The response is the same as when you issue the QUERY 
command with the DISK operand. 
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Other Messages and Return Codes 

DM5FOR003E INVALID OPTION •option' RC=24 

DMSFOR017E INVALID DEVICE ADDRESS 'cuu' RC=24 

DMSFCR028E NO DEVICE SPECIFIED RC=24 

DMSFOR037E DISK 'mode[ (CUU) ]» IS READ/ONLY RC=36 

DMSFOR048E INVALID MODE 'mode 1 RC=24 

DMSF0R069E DISK 'mode' NOT ACCESSED RC=36 

DMSFOR070E INVALID PARAMETER "parameter' RC=24 

DMSF0R113S DEVICE 'cuu' NOT ATTACHED RC=100 

DMSFOR114S 'CUU* IS AN UNSUPPORTED DEVICE TYPE RC=88 

DMSFOR125S PERMANENT UNIT CHECK ON DISK ' mode (cuu) • RC = 100 

DMSFOR126S ERROR { READ | HRIT}ING LABEL ON DISK 'mode (cuu) ' RC=100 

DMSF0R21UW CANNOT RECOMPUTE WITHOUT LOSS OF DATA. NO CHANGE RC=8 
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GENDIRT 

Use the GENDIRT command to fill in a CMS auxiliary directory. The 
auxiliary directory contains the name and location of modules which 
would otherwise significantly increase the size of the resident 
directory, thus increasing search time and storage requirements. By 
using GENDIRT to fill in an auxiliary directory, the file entries for 
the given command are loaded only when the command is invoked. The 
format of the GENDIRT command is: 



| GENDIRT | directoryname [targetmode] I 

• i 



where : 

directoryname 

is the entry point of the auxiliary directory. 

targetmode 

is the filemode letter of the disk containing the modules 
referred to in the directory. The letter is the filemode of 
the disk containing the modules at execution time, not the 
filemode of the disk at creation of the directory. The 
default value for targetmode is S (system disk) . It is your 
responsibility to determine the usefulness of this operand at 
your installation, and to inform all users whose programs are 
in auxiliary directories exactly what filemode to specify on 
the ACCESS command. 

Note: For information on creating auxiliary directories and for further 
requirements for using the targetmode option, see the VMZ370: System 
PE23£§SL5L§£.!.§: Guide. 

I§ssages and Return Codes 

DMSGND002W FILE • f n ft fi» NOT FOUND RC=4 
DMSGND021E ENTRY POINT •name 1 NOT FOUND RC=40 
DMSGND022E NO DIRECTORY NAME SPECIFIED RC=24 
DMSGND070E INVALID PARAMETER 'parameter* RC=24 



Section 2. CMS Commands 107 



GENMOD 



GENMOD 



Use the GENMOD command to generate a nonrelocatable (NODULE) file on a 
CMS disk. The format of the GENMOD command is: 



Genmod 



r t 

[ fn [ MODULE I fm | ]] 
I A 1 | 

L J 

options: [ FROM entry 1 ] [ TO en try 2 ] 

r t r n r i 

| MAP | |STR | I OS | 

| NOMAP | |NOSTR| | DOS | 

»- J l j |ALL| 

[SYSTEM] •- J 



l 



jrhere: 

fn is the filename of the MODULE file being created. If fn is not 
specified, the file created has a filename equal to that of the 
first entry point in the LOAD MAP. 

fm is the filemode of the MODULE file being created. If fm is not 
specified, A1 is assumed. 

Options: If conflicting options are specified, the last one entered 
is used. 

FROM entry 1 specifies an entry point or a control section name, which 
represents the starting virtual storage location from 
which the nonrelocatable copy is generated. 

If FROM is not specified, the starting virtual storage 
location (entry point) of the module is determined 
according to the hierarchy discussed in Usage Note 4 of 
the LOAD command. This is not necessarily the lowest 
address loaded. If you have any external references 
before your START or CSECT instructions, you must specify 
FROM entryl to load your program properly. 

TO entry2 specifies an entry point or a control section name, which 
represents the ending virtual storage location from which 
the nonrelocatable copy is generated. 

MAP includes a load map in the MODULE file, which is an 
80-byte record placed in front of the load module. 

NOMAP specifies that a load map is not to be contained in the 
MODULE file. 

Note: If a module is generated with the NOMAP option, 
that module cannot later be loaded and started with the 
CMS LOADMOD and START commands. When NOMAP is specified, 
the information produced is not sufficient for the START 
command to execute properly. However, a module generated 
with the NOMAP option can later be invoked as a command, 
that is, it can be invoked if its filename is entered. 
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STR invokes the CMS storage initialization routine when the 
MODULE file is subsequently loaded (see the LOADMOD 
command description) . This routine frees any storage 
remaining from a previous program. STR is the default 
setting if the MODULE is to be loaded at the beginning of 
available user storage. 

NOSTR indicates that, when the MODULE is loaded, free storage 
pointers are not reset for any storage currently in use. 
NOSTR is the default setting if the MODULE file is to be 
loaded at a location other than the default load 
address. 

SYSTEM indicates that when the MODULE file is subsequently 
loaded, it is to have a storage protect key of zero. 

OS indicates that the program may contain OS macros, and, 
therefore, should be executed only when CMS/DOS is not 
active. 

DOS indicates that the program contains DOS macros; CMS/DOS 
must be active (that is, SET DOS ON must have been 
previously invoked) in order for this program to execute 
(See Usage Note 2) . 

ALL indicates that the program: 

• Contains CMS macros and must be capable of running 
regardless of whether CMS/DOS is active or not. 

• Contains no DOS or OS macros. 

• Preserves and resets the DOS flag in the CMS nucleus. 

• Does its own setting of the DOS flags. 

Note: The ALL option is primarily for use by CMS system 
programmers. CMS system routines are aware of which 
environment is active, and will preserve and reset the 
DOS flag in the CMS nucleus. 

Usage Notes 

1. The GENMOD command is usually invoked following the LOAD, and 
possibly INCLUDE commands. For example, the sequence 

load myprog 
genmod testprog 

loads the file MYPROG TEXT into virtual storage and creates a 
nonrelocatable load module named TESTPROG MODULE. TESTPROG may now 
be invoked as a user-written command from the CMS environment. 

2. It is not recommended that general users create MODULE files of DOS 
programs. In order for a MODULE file to execute properly under 
CMS/DOS, storage must be properly initialized. 

3. Before the file is written, undefined symbols are set to location 
zero and the common reference control section is initialized. The 
undefined symbols are not retained as unresolved symbols in the 
MODULE file. Therefore, once the MODULE file is generated, those 
references cannot be resolved and may cause unpredictable results 
during execution. 

4. If you load a program into the transient area you should issue the 
GENMOD command with the STR option. Be careful if the program uses 
OS GETMAIN or FREEMAIN macros because your program, plus the amount 
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of storage obtained via GETMAIN, cannot exceed two pages (8192 
bytes) . It is recommended that you do not use GETMAIN macros in 
programs that execute in the transient area. 

5. A transient module (loaded with the ORIGIN TRANS option) that was 
generated with the SYSTEM option is written on disk as a 
fixed-length record with a maximum length of 8192 bytes. 

Responses 
None. 

Messages and Return Codes 

DMSMOD003E INVALID OPTION •option 1 RC=24 

DMSMOD005E NO {FROM|TO} ENTRY SPECIFIED RC=24 

DMSMOD021E ENTRY POINT 'name' NOT FOUND RC=40 

DMSMOD032E INVALID FILETYPE 'ft» RC=24 

DMSMOD037E DISK 'mode* IS READ/ONLY RC=36 

DMSMODOUOE NO FILES LOADED RC=40 

DMSMOD070E INVALID PARAMETER 'parameter' RC=24 

DMSMOD084E INVALID USE OF 'FROM' AND 'TO' OPTIONS RC=24 

DMSMOD105S ERROR »nn' WRITING FILE «fn ft f m • ON DISK RC=100 

DMSSTT048E INVALID MODE 'mode' RC==24 

DMSSTT069E DISK 'mode' NOT ACCESSED RC=36 



110 IBM VM/370: CMS Command and Macro Reference 



GLOBAL 



GLOBAL 



I Use the GLOBAL command to identify which CMS or CMS/DOS libraries are to 
| be searched for macros, copy files, subroutines, or DOS executable 

phases when processing subsequent CMS commands. The format of the 

GLOBAL command is: 



| GLobal | 



I I 
i 



MACLIB 
TXTLIB 
DOSLIB 



[ libnamel 



libname8 ] 



where : 
MACLIB 



TXTLIB 



DOSLIB 



libnamel 



precedes the specification of macro libraries that are to be 
searched for macros and copy files during the execution of 
language processor commands. The macro libraries may be CMS 
files or OS data sets. If you specify an OS data set, a 
FILEDEF command must be issued for the data set before you 
issue the GLOBAL command. 

precedes the specification of text libraries to be searched 
for missing subroutines when the LOAD or INCLUDE command is 
issued, or when a dynamic load occurs (that is, when an OS 
SVC 8 is issued) . 

Note: Subroutines that are called by dynamic load should (1) 
contain only VCONs that are resolved within the same text 
library member or (2) be resident in storage throughout the 
processing of the original CMS LOAD or INCLUDE command. 
Otherwise, the entry point is unpredictable. 

precedes the specification of DOS simulated core image 
libraries (that is, CMS/DOS phase libraries) to be searched 
for missing phases. This operand does not apply to system 
or private core image libraries residing on DOS/VS disks. 
DOSLIB can be specified regardless of whether the CMS/DOS 
environment is active or not. 

is the filename of up to eight libraries. Filetypes must be 
MACLIB, TXTLIB, and DOSLIB, accordingly. The libraries are 
searched in the order in which they are named. If no 
library names are specified, the command cancels the effect 
of any previous GLOBAL command. 



Usage Notes 
1. 



A GLOBAL command remains in effect for an entire CMS session unless 
it is explicitly canceled or reissued. If a program failure forces 
you to re-IPL CMS, you must reissue the GLOBAL command. 

There are no default libraries; if you wish to use the same 
libraries during every terminal session, place the GLOBAL 
command (s) in your PROFILE EXEC. 

If you want to use an OS library during the execution of a language 
processor, you can issue a GLOBAL command to access the library, as 
long as you have defined the library via the FILEDEF command. If 
you want to use that library for more than one job, however, you 
should use the PERM option on the FILEDEF command, since the 
language processors clear nonpermanent file definitions. 
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4. You can find out what libraries have been specified by issuing the 
QUERY command with the MACLIB, TXTLIB, DOSLIB or LIBRARY operands. 
(The LIBRARY operand requests a display of all libraries.) 

5. For information on creating and/or manipulating CMS libraries, see 
the discussion of the MACLIB, TXTLIB and DOSLIB commands. 

Responses 
None. 

Messages and Return Codes 

DMSGLB002W FILE »fn ft* NOT FOUND RC=28 
DMSGLB014E INVALID FUNCTION 'function* RC=24 
DMSGLB0U7E NO FUNCTION SPECIFIED RC = 24 
DMSGLB108S MORE THAN 8 LIBRARIES SPECIFIED RC=88 
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Use the INCLUDE command to read one or more TEXT files (containing 
relocatable object code) from disk and to load them into virtual 
storage, establishing the proper linkages between the files. A LOAD 
command must have been previously issued for the INCLUDE command to 
produce desirable results. For information on the CMS loader and the 
handling of unresolved references, see the description of the LOAD 
command. The format of the INCLUDE command is: 




fn... [ (options. . .[) ]] 
o£tions: r -, r 



|CLEAR | | RESET (entry) | |ORIGIN /hexloc) | 

I * )\ I 1TRANS j| 



I NOCL E A R | 

L J L 



r n r ir t r t r i 

| MAP | | TYPE | |INV | | REP | |AUT?0 | 

|NOMAP| IHOTYPJI |NOINV| |NOREP| |NOAUTO| 

4. J t. J L JL J L J 

r i r t 

lilll I [START] [SAME] |DUP | 

|NOLIBE| |NODUP| 

L J L J 



where : 
fn. . . 



are the names of the files to be loaded into storage. Files 
must have a filetype of TEXT and consist of relocatable object 
code such as that produced by the OS language processor. If a 
GLOBAL TXTLIB command has identified one or more TXTLIBS, fn may 
indicate the name of a TXTLIB member. 



Options: If options were specified with a previous LOAD or INCLUDE 
command, these options (with the exception of CLEAR and ORIGIN) 
remain set if SAME is specified when INCLUDE is issued. Otherwise, 
the options assume their default settings. If conflicting options 
are specified, the last one entered is in effect. 



CLEAR 



clears the load area in storage to binary zeros before 
the files are loaded. 



NOCLEAR 



does not clear the load area before loading. 



RESET 



| entry | 



resets the execution starting point previously 
set by a LOAD or INCLUDE command. If entry is 
specified, the starting execution address is reset to 
the specified location. If an asterisk (*) is 
specified, the starting address is reset to the 
default entry point. 



ORIGIN 



f hexloc) 
\ TRANS / 



begins loading the program at the location specified 
by hexloc. The variable, hexloc, is a hexadecimal 
number of up to 6 characters. If this option is not 
specified, loading begins at the next available 
storage location. INCLUDE does not overlay any 
previously loaded files unless this option is 
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MR 

NOMAP 

TYPE 

NCTYPE 
INV 

NOIHV 

REP 

NOREP 

AUTO 

NOAUTO 
LIBE 

NOLIBE 

START 
SAME 



DUP 



NODUP 



specified and the address given indicates a location 
within a previously loaded object module. TRANS 
indicates that the file is loaded into the transient 
area. 

adds information to the load map. 

does not add any information to the load map. 

displays the load map of the files at the terminal, as 
well as writing it on the A-disk. This option is 
valid only if MAP is specified or implied. 

does not display the load map at the terminal. 

writes invalid card images in the LOAD MAP file. 

does not write invalid card images in the LOAD MAP 
file. 

writes Replace (REP) statement images in the LOAD MAP 
file. See the explanation of the CMS LOAD command for 
a description of the Replace (REP) statement. 

suppresses the writing of Replace (REP) statements in 
the LOAD MAP file. 

searches your disks for TEXT files to resolve 
undefined references. 

suppresses automatic searching for TEXT files. 

searches the text libraries defined by the GLOBAL 
command for missing subroutines. 

does not search any text libraries for unresolved 
references. 

begins execution after loading is completed. 

retains the same options (except ORIGIN and CLEAR) 
that were used by a previous INCLUDE or LOAD command. 
Otherwise, the default setting of unspecified options 
is assumed. If other options are specified with SAME, 
they override previously specified options. (See 
Usage Note 1.) 

displays warning messages at your virtual console when 
a duplicate CSECT is encountered during processing. 
The duplicate CSECT is not loaded. 

does not display warning messages at your virtual 
console when duplicate CSECTs are encountered during 
processing. The duplicate CSECT is not loaded. 



U§§:36 Notes 

1. If you have specified several non-default options on the LOAD 
command, and you want those options to remain in effect, you should 
use the SAME option when you issue the INCLUDE command, for 
example, 

include main subi data (reset main map start) 
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brings the files named MAIN TEXT, SUBI TEXT, and DATA TEXT into 
virtual storage and appends them to files which were previously 
loaded. Information about these loaded files is added to the LOAD 
MAP file. Execution begins at entry point MAIN. 

load myprog (nomap nolibe norep) 

include mysub (map same) 

During execution of the LOAD command, the file named MYPROG TEXT is 
brought into real storage. The following options are in effect: 
NOMAP, NOLIBE, NOREP, NOTYPE, INV, AUTO. During execution of the 
INCLUDE command, the file named MYSUB TEXT is appended to MYPROG 
TEXT. The following options are in effect: 

MAP, NOLIBE, NOREP, NOTYPE, INV, AUTO 

2. For additional information on the CMS loader, see the discussion of 
the LOAD command, or consult VM/370: CMS User^s Guide. 

Responses 

DMSLI0740I EXECUTION BEGINS... 

START was specified with INCLUDE and the loaded program has begun 
execution. Any further responses are from the program. 

INVALID CARD - XXX . . . XXX 

INV was specified with LOAD and an invalid card has been found. 
The message and the contents of the invalid card (xxx...xxx) are 
listed in the LOAD MAP file. The invalid card is ignored and 
loading continues. 

Other Messages and Return Codes 

DMSLGT002I FILE • f n» TXTLIB NOT FOUND RC=0 

DMSLIO001E NO FILENAME SPECIFIED RC=24 

DMSLIO002E FILE • f n ft* NOT FOUND RC=28 

DMSLIO003E INVALID OPTION 'option* RC=2U 

DMSLIO005E NO 'option' SPECIFIED RC=24 

DMSLIO021E ENTRY POINT 'name' NOT FOUND RC=40 

DMSLIO029E INVALID PARAMETER 'parameter' IN THE OPTION 'option' FIELD 

RC=24 
DMSLI0055E NO ENTRY POINT DEFINED RC=U0 
DMSLIO056E FILE 'fn ft' CONTAINS INVALID [ NAME | ALIAS |ENTRY |ESD ] RECORD 

FORMATS RC=32 
DMSLIO099E CMS/DOS ENVIRONMENT ACTIVE RC=40 

DMSLIO10US ERROR »nn» READING FILE «fn ft f m • FROM DISK RC=100 
DMSLIO105S ERROR »nn' WRITING FILE • f n ft fm' ON DISK RC=100 
DMSLIO109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
DMSLI0116S LOADER TABLE OVERFLOW RC=104 
DMSLI0168S PSEUDO REGISTER TABLE OVERFLOW RC=104 
DMSLI0169S ESDID TABLE OVERFLOW RC=10U 
DMSLI0201W THE FOLLOWING NAMES ARE UNDEFINED: RC=4 
DMSLI0202W DUPLICATE IDENTIFIER 'identifier' RC=4 
DMSLIO203W "SET LOCATION COUNTER" NAME 'name' UNDEFINED RC=U 
DMSLIO206W PSEUDO REGISTER ALIGNMENT ERROR RC=U 
DMSLIO907T I/O ERROR ON FILE 'fn ft fm' RC=256 
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I Use the LISTDS command to list, at your terminal, information about the 

J data sets or files residing on accessed OS or DOS disks, or to display 

| extent or free space information when you want to allocate space for 

j VSAM files. The format of the LISTDS command is: 



/ f m ) [ (options 
LISTDS | |dsname| \ * / 

L J 

(FREE) 



.[) ]] 



{:■} 



options: 
f FORM AT] 
[PDS ] 
[EXTENT] 



where: 



indicates that you want to enter the OS data set name, DOS 
file-id, or VSAM data space name interactively. When you 
enter a question mark (?) , CMS prompts you to enter the OS 
data set name, DOS file- id, or VSAM data space name exactly 
as it appears on the disk. This form allows you to enter 
names that contain embedded blanks or hyphens. 



dsname is the OS data set name or DOS 
name and takes the form: 



file-id or VSAM data space 



quail [qual2 qualn] 

where quail, qual2 through qualn are 1- to 8-character 
qualifiers normally separated by periods. Each qualifier 
must be separated from other qualifiers by blanks when you 
enter them this way. (See Usage Note 1.) 

fm is the filemode of the disk to be searched for the specified 
file. If a dsname is not specified, a list of all the files 
or data sets on the specified disk is displayed. 

* indicates that you want all of your accessed DOS or OS disks 

searched for the specified data set or file. If a dsname is 
not specified, a list of all files on all accessed OS and DOS 
disks is displayed. 

| Options: The FREE and EXTENT options are mutually exclusive; the 
| FORMAT and PDS options cannot be specified with either FREE or 
| EXTENT. 

| FREE requests a display of all free space extents on a specific 
| minidisk or on all accessed DOS and OS disks. If you enter 

| the FREE option, you cannot specify a dsname. 

| EXTENT requests a display of allocated extents for a single file, 

| EX or for an entire disk or minidisk. If a dsname is specified, 

| only the extents for that particular file or data set are 

| listed; if fm is specified as *, all disks are searched for 

| extents occupied by that file. 

| If a dsname is not specified, then a list of all currently 

| allocated extents on the specified disk, or on all disks, is 

I displayed. 
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FORMAT requests a display of the date, disk label, filemode, and 
FO data set name for an OS data set as well as RECFM, LRECL, 
BLKSIZE, and DSORG information. For a DOS file, LISTDS 
displays the date, disk label, filemode, and file-id, but 
gives no information about the RECFM, LRECL, and BLKSIZE (two 
blanks appear for each) ; DSORG is always PS. 

PDS displays the member names of referenced OS partitioned data 
sets. 

For examples of the displays produced as a result of each of these 
options, see the "Responses" section, below. 

Usage Notes 

1. If you want to enter an OS or DOS file identification on the LISTDS 
command line, it must consist of 1- to 8-character qualifiers 
separated by periods. For example, the file TEST. INPUT. SOURCE. D 
could be listed as follows: 

listds test input source d * 

Or, you can enter the name interactively, as follows: 

listds ? * 

DMSLDS220R ENTER DATA SET NAME: 

test .input .source.d 

Note that when the data set name is entered interactively, it must 
be entered in its exact form; when entered on the LISTDS command 
line, the periods must be omitted. 

You must use the interactive form to enter a DOS file-id that 
contains embedded blanks or hyphens. 

2. You should use the FREE option to determine what free space is 
available for allocation by VSAM when you are using Access Method 
Services. For example, 

listds * (free 

requests a display of unallocated extents on all accessed OS or DOS 
disks. You can then use the EXTENT option on the DLBL command when 
you define the file for AMSERV. 

Responses 

DMSLDS220R ENTER DATA SET NAME: 

This message prompts you to enter the data set name when you use 
the ? operand on the LISTDS command. Enter the file identf ication 
in its exact form. A sample sequence might be: 

listds ? c 

DMSLDS220R ENTER DATA SET NAME: 

my.f ile. test 

FM DATA SET NAME 

C MY. FILE. TEST 

R; 

The response shown above following the entry of the data set name 
is the same as the response given when you enter a data set name on 
the LISTDS command line. 
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DMSLDS229I NO MEMBERS FOUND 

This message is displayed when you use the EDS option and the data 
set has no members. 

DMSLDS233I NO FREE SPACE AVAILABLE ON , fm« DISK 

This message is displayed when you use the FREE option and there is 
no free space available on the specified disk. 

ies£onses to the EXTENT Ojrtion: A sample response to the EXTENT option 
is shown below. The headers and the type of information supplied are the 
same when you request information for a specific file only, or for all 
disks. 

listds g (extent 

EXTENT INFORMATION FOR »VTOC' ON "G» DISK: 

SEQ TYPE CYL-HD (RELTRK) TO CYL-HD (RELTRK) TRACKS 

000 VTOC 099 00 1881 099 18 1899 19 

EXTENT INFORMATION FOR • PRIVAT . CORE. IMAGE .LIB • ON 'G* DISK: 
SEQ TYPE CYL-HD (RELTRK) TO CYL-HD (RELTRK) TRACKS 
000 DATA 000 01 1 049 18 949 949 

EXTENT INFORMATION FOR » SYSTEM . WORK. FILE. NO. 6 • ON «G' DISK: 
SEQ TYPE CYL-HD (RELTRK) TO CYL-HD (RELTRK) TRACKS 
000 DATA 050 00 950 051 18 987 38 

EXTENT INFORMATION FOR •COBOL TEST PROGRAM' ON »G' DISK: 
SEQ TYPE CYL-HD (RELTRK) TO CYL-HD (RELTRK) TRACKS 
000 DATA 052 02 990 054 01 1027 38 

EXTENT INFORMATION FOR • DKSQ01A* ON «G' DISK: 

SEQ TYPE CYL-HD (RELTRK) TO CYL-HD (RELTRK) TRACKS 

000 DATA 080 01 1521 081 00 1539 19 

where : 

SEQ indicates the sequence number assigned this extent when the 
extents were defined via the DLBL command. CMS assigns the 
sequence numbers for VSAM data sets; the first extent set has a 
sequence of 000, the second extent has a sequence of 001, and so 
on. 

TYPE can be DATA, VTOC, SPLIT, LABEL, INDEX or OVFLO. 

DATA refers to a data area extent. 

VTOC refers to the VTOC extent of the disk. 

SPLIT refers to a split cylinder extent. 

LABEL refers to a user label extent. 

INDEX refers to an ISAM index area extent. 

OVFLO refers to an ISAM independent overflow area extent. 

CYL-HD (RELTRK) TO CYL-HD (RELTRK) 

indicates the cylinder, head, and relative track numbers of the 
start and end tracks of this extent. 

TRACKS indicates the number of tracks in the extent. 

Mej5|>onse to the FRII 2£tion: A sample response to the FREE option is 
shown below. The same headers and type of information is shown when you 
request free information for all accessed disks. 
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I 



listds g (free 

FREESPACE EXTENTS FOR *G* DISK: 
CYL-HD(RELTRK) TO CYL-HD (RELTRK) 
052 00 988 052 01 989 
054 02 1028 080 00 1520 
081 01 1540 098 18 1880 



TRACKS 

2 

493 

341 



| where : 



CYL-HD (RELTRK) TO CYL-HD (RELTRK) 

indicates the cylinder, head and relative track numbers of the 
starting and ending track in the free extent. 



| TRACKS indicates the total number of free tracks in the extent. 

Response to the FORMAT and PDS Options: If you enter the FORMAT and PDS 
options, you receive information similar to the following: 

listds d (fo pds) 

RECFM LRECL BLKSI DSORG 

FB 80 800 PO 
MEMBER NAMES: 
ABEND ATTACH BLDL 
FIND PUT READ 
RECFM LRECL BLKSI DSORG 

F 80 80 PS 



DATE 


LABEL 


FM 


DATA SET NAME 




01/31/75 


OSSYS1 


D 


SYS1.MACLIB 




BSP 


CLOSE 




DCB DETACH 


DEVTYPE 


WRITE 


XDAP 








DATE 


LABEL 


FM 


DATA SET NAME 




01/10/75 


OSSYS1 


D 


SAMPLE 





Other Messages and Return Codes 



DMSLDS002E 
DMSLDS003E 
DMSLDS048E 
DMSLDS069E 

| DMSLDS117E 
DMSLDS221E 

| DMSLDS222E 

DMSLDS223E 
| DMSLDS226E 
| DMSLDS227W 

I 

| DMSLDS231E 



DATA SET NOT FOUND RC=28 

INVALID OPTION • option* RC=24 

INVALID MODE 'mode' RC=24 

DISK •mode* NOT ACCESSED RC=36 

INVALID EXTENT FOUND FOR *data set name* ON *fm* DISK RC=24 

INVALID DATA SET NAME RC=24 

I/O ERROB READING 'data set name* FROM {fm|OS|DOS} DISK 

RC = 28 

NO FILEMODE SPECIFIED RC=24 

NO DATA SET NAME ALLOWED WITH FREE OPTION RC=24 

INVALID EXTENT FOUND FOR • datasetname' ON {fm|OS|DOS} DISK 

RC = 4 

I/O ERROR READING VTOC FROM {fm|OS|DOS} DISK RC=28 
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Use the LISTFILE command to obtain specified information about CMS files 
residing on accessed disks. The format of the LISTFILE command is: 




r r r m 

|fn | ft |fm||| [ (options.. .[) ]] 

I* I* 1*111 

L L L JJJ 

2£tions: r n r i r ■% 
| Header | |Exec | |FName 
|NOHeader| |APpend| | FType 
l j l j IFMode 

I Format 
lALloc 
|Date 
| Label 



where : 

fn is the filename of the files for which information is to be 
collected. If an asterisk is coded in this field, all filenames 
are used. If you code an asterisk preceded by any number of 
characters, then files that begin with the specified characters are 
listed. 

ft is the filetype of the files for which information is to be 
collected. If an asterisk is coded in this field, all filetypes 
are used. If you code an asterisk preceded by any number of 
characters, then files that begin with the specified characters are 
listed. 

fm is the filemode of the files for which information is to be 
collected. If this field is omitted, only the A-disk is searched. 
If an asterisk is coded, all disks are searched. 

9-BiEUt Format Options:' 

HEADER includes column headings in the listing. HEADER is the 
default if any of the supplemental information options 
(FORMAT,, ALLOCATE, DATE, LABEL) are specified. The format 
of the heading is: 

FILENAME FILETYPE FM FORMAT RECS BLOCKS DATE TIME LABEL 

NOHEADER does not include column headings in the list. NOHEADER is 
the default if only filename, filetype, or filemode 
information is reguested. 

Output Disposition Options: 

EXEC creates a CMS EXEC file of 80-character records (one record 
for each of the files which satisfies the given file 
identifier) on your A-disk. If a CMS EXEC already exists, 
it is replaced. The header is not included in the file. 
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APPEND creates a CMS EXEC and appends it to the existing CMS EXEC 
file. If no CMS EXEC file exists, one is created. 

Information ISSHi-st Options: Only one of these options need be 
specified. If one is specified, any options with a higher priority 
are also in effect. If none of the following options are specified, 
the default information request options are in effect. 

Default Iiifj2£J!§ii5Ii S§3i?§si O£i±ons: 

FNAME creates a list containing only filenames. Option priority 
is 7. 

FTYPE creates a list containing only filenames and filetypes. 
Option priority is 6. 

FMODE creates a list containing filenames, filetypes, and 
filemodes. Option priority is 5. 

Supplemental Information Options: 

FORMAT includes the record format and logical record length of the 
of each file in the list. Option priority is 4. 

ALLOC includes the amount of disk space that CMS has allocated to 
the specified file in the list. The quantities given are 
the number of 800-byte blocks and the number of logical 
records in the file. Option priority is 3. 

DATE includes the date the file was last written in the list. 
The form of the date is: 

month/day /year hour: minute 

Option priority is 2. 

LABEL includes the label of the disk on which the file resides in 
the list. Option priority is 1. 

Osage Notes 

1. If you enter the LISTFILE command with no operands, a list of all 
files on your A-disk is displayed at the terminal. If you enter 

listfile a* f* c 

you might see the display 

AARDVARK FILE C5 
ANNA FILEDATA C1 
AUTHOR FLINDEX C1 

2. If you request any additional information with the supplemental 
information options, that information is also displayed, along with 
the header. 

3. When you use the EXEC or APPEND option, the CMS EXEC A1 that is 
created is in the format 

S1 &2 filename filetype fm ... 

where column 1 is blank. 
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If you use any of the supplemental information options, that 
information is included in the EXEC file. For information on using 
CMS EXEC files, VM/370: CMS User^s Guide. 

Responses 

If the EXEC or APPEND option is not specified, the requested information 
is displayed at the terminal. Depending on the options specified, or 
discussed above, the information displayed is: 

FILENAME FILETYPE FM FORMAT RECS BLOCKS DATE TIME LABEL 

8 

fn ASSEMBLE f m ) V ( lrecl norecs noblks mm/dd/yy hh:mm volid 



One entry is displayed for each file listed, 
w her e : 

fn is the filename of the file, 
ft is the filetype of the file, 
fm is the filemode of the file 

is the file format: F is fixed-length, V is variable- 
length. 

lrecl is the logical record length of the largest record in the 
file. 

norecs is the number of logical records in the file. 

noblks is the number of physical blocks that the file occupies 
on disk. 

mm/dd/yy is the date (month/day/year) that the file was created. 

hh: mm is the time (hours: minutes) that the file was created. 

volid is the volume serial number of the virtual disk on which 
the file resides. 

.Qther Messages and Return Codes 

DMSLST002E FILE NOT FOUND RC=28 

DMSLST003E INVALID OPTION 'option 1 RC=24 

DMSLST037E DISK •mode 11 IS READ/ONLY RC=36 

DMSLST048E INVALID MODE 'mode' RC=24 

DMSLST066E 'option' and 'option' ARE CONFLICTING OPTIONS RC=24 

DMSLST069E DISK 'mode' NOT ACCESSED RC=36 

DMSLST070E INVALID PARAMETER 'parameter' RC=24 

DMSLST105S ERROR 'nn' WRITING FILE • f n ft fm' ON DISK RC=100 

Notes You can invoke the LISTFILE command from the terminal, from an 
EXEC file, or as a function from a program. If LISTFILE is invoked as a 
function or from an EXEC file that has the &CONTROL NOMSG option in 
effect, the DMSLST002E FILE NOT FOUND error message is not issued. 
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Use the LISTIO command in CMS/DOS to display a list of current 
assignments for system and/or programmer logical units in your virtual 
machine. The format of the LISTIO command is: 



LISTIO 



SYS 

PROG 

SYSXXX 

A 

UA 

ALL 



[ (options. . .[) ]] 



options : 

r t 

| EXEC | [STAT] 
| APPEND | 

L J 



I 



where 
SYS 

PROG 



reguests a list of the physical devices assigned to all system 
logical units. 

reguests a list of the physical devices assigned to programmer 
logical units SYS000 through SYS241. 



SYSxxx reguests a display of the physical device assigned to the 
particular logical unit specified. 

A reguests a list of only those logical units that have been 
assigned to physical devices. 

UA reguests a list of only those logical units that have not been 
assigned to physical devices, that is, that are unassigned. 

ALL reguests a list of the physical units assigned to all system and 
programmer logical units. If no operand is specified, ALL is the 
default. 

Options: The EXEC and APPEND options are mutually exclusive; if both 
are entered on the command line, the last one entered is in effect. 

EXEC erases the existing $LISTIO EXEC file, if one exists, and 
creates a new one. 

APPEND adds new entries to the end of an existing $LISTIO EXEC file. 
If no $LISTIO EXEC file exists, a new one is created. 

STAT lists the status (read-only or read/write) of all disk devices 
current assigned. 

Usage Notes 

1. Logical units are assigned and unassigned with the ASSGN command. 
For a list of logical units and valid device types, see the 
discussion of the ASSGN command. 

2. The $LISTIO EXEC contains one record for each logical unit listed. 
The format is: 



S1 &2 SYSxxx 



/ device \ 
\ mode [status ] J 



where column 1 is blank. 
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I I§§£onses 

I Depending on the operands specified, the following is displayed for each 
I unit requested in the LISTIO command: 

| SYSxxx (device ) 
I \ mode [ status] j 

| where device is the device type (READER, PRINTER, PUNCH, TERMINAL, TAPn, 
| IGN, or UA) . If the device is a disk, the 1-character mode letter is 
| displayed. If the STAT option is specified, the status (R/0 or R/W) is 
I also displayed. 

I Other Messages and Return Codes 

| DMSLLU003E INVALID OPTION »option" RC=2U 

| DMSLLU006E NO READ/WRITE 'A' DISK ACCESSED RC=36 

| DMSLLU070E INVALID PARAMETER 'parameter* RC=2U 

| DMSLLU099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

| DMSLLU105S ERROR • nn ■ WRITING FILE «$LISTIO EXEC AT ON DISK RC=100 
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Dse the LOAD command to read one or more CHS or OS TEXT files 
(containing relocatable object code) from disk and to load them into 
virtual storage, establishing the proper linkages between the files. 
The format of the LOAD command is: 



LOAD 



fn 



[ (options. . .[ ) ] ] 



r t 

options: | CLEAR | 

|NOCLEAR| 



r t 

| RESET / entry \| 
* 



jentryjj 



r t 

IORIGIN / hexloc) | 



r t 

I MA£ I 
|NOMAP| 

L J 

r t 

I LIB J I 
|NOLIBE| 

L J 



r i 
|TYPE | 
|NOTYPE| 

[START] 



r t 
|INV | 
|NOINV| 

L J 

r t 

|DUP | 
|NODUP| 

L J 



( hexloc) | 
\ TRANS j\ 



IJEP | 
|NOREP| 

L J 



r t 

| AUTO | 
|NOADTO| 

L J 



w h er e : 
f n. . . 



specifies the names of the files to be loaded into storage. The 
files must have a filetype of TEXT and consist of relocatable 
object code such as that produced by the OS language 
processors. If a GLOBAL TXTLIB command has been issued, fn may 
indicate the name of a TXTLIB member. 



Options: If conflicting options are specified, the last one entered 
is in effect. Options may be overidden or added when you use the 
INCLUDE command to load additional TEXT files. 

CLEAR clears the load area in storage before the object files are 

loaded. Whole page frames are released; the remainder of 

storage that is not on a page boundary is set to binary 
zeros. 



NOCLEAR does not clear the load area before loading 



RESET 



{entry J 

sets the starting location for the programs currently loaded. 
The operand, entry, must be an external name (for example, 
CSECT or ENTRY) in the loaded programs. If RESET is not 
specified, the default entry point is used. (See Usage Note 
4.) If * is entered the results are the same as if the RESET 
option were omitted. 



ORIGIN 



/ hexloc ) 
\ TRANS / 



hexloc 
TRANS 

loads the program beginning at the location specified by 
hexloc; this location must be in the CMS nucleus transient 
area or in the user area. The location, hexloc, is a 
hexadecimal number of up to 6 characters. If TRANS is 
specified, the file is loaded into the CMS nucleus transient 
area. If ORIGIN is not specified, loading begins at the 
first available storage location in the user program area. 
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Note: Any program loaded into the transient area must have a 
starting address of X'EOOO'. See the discussion of the 
GENMOD command for information on loading programs in the 
transient area. 

MAP writes a load map on your A-disk r named LOAD MAP A5. 
NOMAP does not create the LOAD MAP file. 

TYPE displays the load map at your terminal, as well as writing it 
on the A-disk. This option is valid only if the MAP option 
is in effect. 

NGTYPE does not display the load map at the terminal. 

IJJ¥ includes invalid card images in the load map. 

NOINV does not include invalid card images in the load map. 

REP includes Replace (REP) statements in the load map. 

NOREP does not include the Replace (REP) statements in the load 
map . 

AUTO searches your virtual disks for TEXT files to resolve 
undefined references. 

NOAUTO suppresses automatic searching for TEXT files. 

kill searches the text libraries for missing subroutines. If text 
libraries are to be searched for TEXT files, they must 
previously have been defined by a GLOBAL command, 

NCLIBE does not search the text libraries for unresolved 
references. 

START executes the program being loaded when loading is completed. 
LOAD does not normally begin execution of the loaded files. 
To begin execution immediately upon successful completion of 
loading, specify START. Execution begins at the default 
entry point (See Usage Note 4) . 

DUP displays warning messages at your terminal when a duplicate 
CSECT is encountered during processing. The duplicate CSECT 
is not loaded. (See Usage Note 3.) 

NODUP does not display warning messages at your terminal when 
duplicate CSECTs are encountered during processing. The 
duplicate CSECT is not loaded. 

Usage Notes 

1. You must have a read/write CMS A-disk accessed when you issue the 
LOAD command; the loader creates a temporary workfile named DMSLDR 
SYSUT1 and writes it on the A-disk. 
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Unless the NOMAP option is specified, a load map is created on the 
A-disk each time the LOAD command is issued. A load map is a file 
that contains the location of control sections and entry points of 
files loaded into storage. This load map is named LOAD MAP A5. 
Each time LOAD is issued, a new LOAD MAP file replaces any previous 
LOAD MAP file. 

If invalid card images exist in the file or files that are being 
loaded, they are listed with the message INVALID CARD in the LOAD 
MAP file. To suppress this listing in the load map, use the NOINV 
option. 

If replace (REP) statements exist in the file being loaded, they 
are included in the LOAD MAP file. To suppress this listing of REP 
statements, specify the NOREP option. 

If the ENTRY or LIBRARY control cards are encountered in the 
file, the load map contains an entry 

CONTROL CARD- ... 

listing the card that was read. 

Duplicate CSECTs (control sections) are bypassed by the loader. 
Only the first CSECT encountered is physically loaded. The 
duplicates are not loaded. A warning message is displayed at your 
terminal if you specified the DUP option. 

The loader selects the entry point for the loaded program according 
to the following hierarchy: 

• From the parameter list on the START command. 

• From the last RESET operand in a LOAD or INCLUDE command. 

• From the last ENTRY statement in the input. 

• From the last LDT statement in the input. 

• From the first assembler- or compiler-produced END statement 
that specifies an entry point if no ENTRY statement is in the 
input. 

• From the first byte of the first control section of the loaded 
program if there is no ENTRY statement and no assembler- or 
compiler-produced END statement specifying an entry point. 

The LOAD command should not be used to execute programs containing 
DOS macros. To link-edit and execute programs in the CMS/DOS 
environment, use the DOSLKED and FETCH commands. 

See Figure 8 for an illustration of the leader search order. The 
loader uses this search order to locate the filename on the LOAD 
and INCLUDE command lines, as well as in the handling of unresolved 
references. 

The CMS loader also loads routines called dynamically by OS LINK, 
LOAD, and XCTL macros. Under certain circumstances, an incorrect 
entry point may be returned to the calling program. See the 
1H£370: CMS UserJ_s Guide for more details. 
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| Use standard order of search to | 
| locate the TEXT files specified | 
I by f n . . . ] 



, * Any * 
unresolved 
references 

* 
IYES 




Search 
| complete 



j 



. * . 
* Is * 

NOAUTO 
specified 



* 
| NO 




| Use standard order of search to | 

I locate files with a filetype of | 

I TEXT and a filename correspond- | 

| ing to the unresolved reference | 






. * Any * . 






* 


unresolved 


* . 


NO 




references 


. 


* 


* 


? 

* . . * 
* 

| YES 

1 

. * Is * . 


* 




* 


NOLIBE 


* . 


YES 




specified 


. 


* 


* 


? 


* 





| Search 
| complete 



Search 
complete 



NO 



Search active text libraries 
(those that were previously 
specified by a GLOBAL command) . 
Files are searched in the order 
they are entered in the command. 



j Search complete | 



Figure 8. Loader Search Order 
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Loader Control Statements 

You can add loader control statements to TEXT files either by editing 
them, or by punching real cards and adding them to a punched text deck 
before reading it into your virtual machine. The five control cards 
recognized by the CMS loader are discussed below. 

The ENTRY and LIBRARY cards, which are discussed first, are similar 
to the OS linkage editor control statements ENTRY and LIBRARY. The CMS 
ENTRY and LIBRARY statements must be entered beginning in column 1. 

ENTRY Statement: The ENTRY statement specifies the first instruction to 
be executed. It can be placed before, between, or after object modules 
or other control statements. The format of the ENTRY statement is shown 
in Figure 9. The external name is the name of a control section or an 
entry name in the input deck. It must be the name of an instruction, 
not of data. 

| ENTRY | external name 



Figure 9. ENTRY Statement Format 



LIBRARY Statement: The LIBRARY statement can be used to specify the 
never-call function. The never-call function (indicated by an asterisk, 
*, as the first operand) specifies those external references that are 
not to be resolved by the automatic library call during any loader step. 
It is negated when a deck containing the external name referred to is 
included as part of the input to the loader. The format of the LIBRARY 
statement is shown in Figure 10. The external reference refers to an 
external reference that may be unresolved after input processing. It is 
not to be resolved. Multiple external references within the parentheses 
must be separated by commas. The LIBRARY statement can be placed 
before, between, or after object decks or other control statements. 

| LIBRARY | * (external reference) I 

Figure 10. LIBRARY Statement Format 
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Loader Terminate (LDT) Statement: The LDT statement is used in a text 

library as the last record of a member. It indicates to the loader that 

all records for that member were processed. The LDT statement can 

contain a name to be used as the entry point for the loaded member. The 
LDT statement has the format shown in Figure 11. 




Contents 

X»02« (12-2-9 punch) . 

Identifies this as a loader control statement. 

LDT — identifies type of statement. 

Not used. 

Blank or entry name (left justified and padded with 
blanks to 8 characters) . 

Blank 

May contain information specified on a SETSS1 card 
processed by the TXTLIB command. 

Not used. 



Figure 11. LDT Statement Format 



l££l!!.de Control Section (ICS) Statement: The ICS statement changes the 
length of a specified control section or defines a new control section. 
It should be used only when REP statements cause a control section to be 
increased in length. The format of an ICS statement is shown in Figure 
12. An ICS statement must be placed at the front of the file or TEXT 
file. 



Column 
1 

2-4 

5-16 
17-22 

23 

24 
25-28 

29 
30-72 
73-80 



Contents 



X«02' (12-2-9 punch) . 

Identifies this as a loader control statement. 

ICS — identifies the type of load statement. 

Blank. 

Control section name — left-justified in these columns. 

Blank. 

, (comma) . 

Hexadecimal length in bytes of the control section. This 
must not be less than the actual length of the previously 
specified control section. It must be right— justified in 
columns with unused leading columns filled with zeros. 

Blank. 

May be used for comments or left blank. 

Not used by the loader. You may leave these columns blank 
or insert program identification for your own convenience. 



Figure 12. ICS Statement Format 
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Set Location Counter (SLC) Statement: The SLC statement sets the 
location counter used with the loader. The file loaded after the SLC 
statement is placed in virtual storage beginning at the address set by 
this SLC statement. The SLC statement has the format shown in Figure 
13. It sets the location counter in one of three ways: 

1. With the absolute virtual address specified as a hexadecimal number 
in columns 7-12. 



With the symbolic address already defined as a 
entry point. This is specified by a symbolic 
columns 17-22. 



program name or 
name punched in 



If both a hexadecimal 
the absolute virtual 
the address assigned 
the address to which 
example, if 0000F8 wa 
image and GAMMA was sp 
assigned address of 
columns 7-12 is added 
total of 0061F8. Th 
0061F8. 



address and a 
address is conv 
to the symbolic 

the loader's 1 
s specified in 
ecified in col 
06100 (hexadeci 

to the addres 
us. the locati 



symbolic name are specified, 

erted to binary and added to 

name; the resulting sum is 

ocation counter is set. For 

columns 7-12 of the SLC card 
umns 17-22, where GAMMA has an 
mal) , the absolute address in 
s assigned to GAMMA giving a 
on counter would be set to 



Column | Contents 

1 I X , 02' (12-2-9 punch) . 

Identifies this as a loader control statement. 

2-4 I SLC — identifies the type of load statement. 

5-6 I Blank. 

7-12 | Hexadecimal address to be added to the value of the symbol, 
if any, in columns 17-22. It must be right-justified in 
these columns, with unused leading columns filled with 
zeros. 

13-16 | Blank. 

17-22 I Symbolic name whose assigned location is used by the 

loader. Must be left- justified in these columns. If blank, 
the address in the absolute field is used. 

23 I Blank. 

24—72 I May be used for comments or left blank. 

73-80 | Not used by the loader. You may leave these columns 
blank or insert program identification for your own 
convenience. 



Figure 13. SLC Statement Format 
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J*ii£lace (BEP) Statement: A REP statemen 
constants to be changed and additions made, 
punched in hexadecimal code. The format of 
Figure 14. The data in columns 17-70 (exc 
what has already been loaded into virtual 
address specified in columns 7-12. REP st 
file either (1) immediately preceding the la 
if the text deck does not contain reloca 
constants, or (2) immediately preceding 
dictionary) statement if there is relocatabl 
additions made by REP statements increase 
section, an ICS statement, which defines the 
section, must be placed at the front of the 



t allows instructions and 
The REP statement must be 

a REP statement is shown in 
luding the commas) replaces 

storage, beginning at the 
atements are placed in the 
st statement (END statement) 
table data such as address 
the first RLD (relocatable 
e data in the text deck. If 
the length of a control 

total length of the control 
deck. 



Column j Contents 

1 | X'02« (12-2-9 punch) . 

! Identifies this as a loader control statement. 

2-4 | REP — identifies the type of load statement. 

5-6 I Blank. 

7-12 I Hexadecimal starting address of the area to be replaced as 
assigned by the assembler. It must be right— justified in 
in these columns with unused leading columns filled with 
zeros. 

13-14 I Blank. 

15-16 I ESID (External Symbol Identification) — the hexadecimal 

number assigned to the control section in which replacement 
is to be made. The LISTING file produced by the compiler 
or assembler indicates this number. 

17-70 I A maximum of 1 1 four-digit hexadecimal fields, separated by 
commas, each replacing one previously loaded halfword (two 
bytes) . The last field must not be followed by a comma. 

Blank. 

Not used by the loader. This field may be left blank or 
program identification may be inserted. 

REP Statement Format 




Responses 

DMSLIO740I EXECUTION BEGINS... 

START was specified with LOAD and the loaded program starts 
execution. Any further responses are from the program. 

INVALID CARD - XXX... xxx 

INV was specified with LOAD and an invalid statement was found. 
The message and the contents of the invalid statement (xxx... xxx) 
are listed in the file LOAD MAP. The invalid statement is ignored 
and loading continues. 
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Ot]l§£ i?§§sac[es and Return Codes 

| DMSLGT002I FILE «fn TXTLIB* NOT FOUND RC=0 

DMSLI0001E NO FILENAME SPECIFIED RC=2U 

DMSLIO002E FILE ■ f n ft' NOT FOUND RC=28 

DMSLIO003E INVALID OPTION 'option* RC = 24 

DMSLIO005E NO 'option 1 SPECIFIED RC=2U 

DMSLIO021E ENTRY POINT 'name 1 NOT FOUND RC=40 

DMSLIO029E INVALID PARAMETER 'parameter' IN THE OPTION 'option 1 FIELD KCwJ$<| 

DMSLI0055E NO ENTRY POINT DEFINED RC=40 

DMSLIO056E FILE ' f n ft' CONTAINS INVALID [ NAME | ALIAS | ENTRY | ESD ] RECORD 
FORMATS RC=32 
| DMSLIO099E CMS/DOS ENVIRONMENT ACTIVE RC=40 

DMSLIO104S ERROR «nn' READING FILE • f n ft fin' FROM DISK RC=100 

DMSLIO105S ERROR » nn ' WRITING FILE 'fn ft f m • ON DISK RC=100 

DMSLIO109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSLI0116S LOADER TABLE OVERFLOW RC=104 

DMSLI0168S PSEUDO REGISTER TABLE OVERFLOW RC=104 

DMSLI0169S ESDID TABLE OVERFLOW RC=104 

DMSLI0201W THE FOLLOWING NAMES ARE UNDEFINED: RC=U 

DMSLIO202W DUPLICATE IDENTIFIER 'identifier' RC=4 

DMSLIO203W "SET LOCATION COUNTER" NAME 'name' UNDEFINED RC=4 

DMSLIO206W PSEUDO REGISTER ALIGNMENT ERROR RC=4 

DMSLIO907T I/O ERROR ON FILE • f n ft fm» RC=256 

DMSSTT062E INVALID * IN FILEID RC=20 
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Use the LOADMOD command to load a MODULE file into storage. The file 
must be in nonrelocatable format as created by the GENMOD command. The 
format of the LOADMOD command is: 



| LOADMod | fn [MODULE [ f m ] ] I 



w her e : 

fn is the filename of the file to be loaded into storage. The 
filetype must be MODULE. 

fm is the filemode of the module to be loaded. If not specified, or 
specified as an asterisk, all your disks are searched for the 
file. 

Hi.Ha§ Notes 

1. You can use the LOADMOD command when you want to debug a CMS MODULE 
file. After the file is loaded, you may set address stops or 
breakpoints before you begin execution with the START command, for 
example: 

loadmap progl 
cp adstop 210ae 
start 

2. If a MODULE file was created using the DOS option of the GENMOD 
command, the CMS/DOS environment must be active when it is loaded. 
If it was created using the OS option (the default) , the CMS/DOS 
environment must not be active when it is loaded. 

MODULE files created with the ALL option, or with SYSTEM option and 
loaded into the transient area, may be loaded regardless of whether 
the CMS/DOS environment is active. If the LOADMOD command is 
called from a program, the loading is also done regardless of 
whether the CMS/DOS environment is active. 

Responses 
None. 

Messages and Return Codes 

DMSMOD001E NO FILENAME SPECIFIED RC=24 

DMSMOD002E FILE »fn ft* NOT FOUND RC=28 

DMSMOD032E INVALID FILETYPE 'ft' RC=24 

DMSMOD070E INVALID PARAMETER 'parameter' RC=24 

DMSMOD104S ERROR • nn' READING FILE • f n ft f m • FROM DISK RC=100 

DMSMOD109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSMOD114E • f n ft fm» NOT LOADED; CMS/DOS ENVIRONMENT [NOT] ACTIVE 

RC=40 or -5 
DMSMOD116S LOADER TABLE OVERFLOW RC=1 04 
DMSSTT048E INVALID MODE 'mode' RC=24 
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Use the MACLIB command to create and modify CMS macro libraries, 
format of the MACLIB command is: 



The 




~ — i 



GEN 

ADD libname fn1 [fn2...] 

REP 

DEL libname membernamel [ membername2. 

COMP libname 

MAP libname [ (options. ..[)] ] 

op_t ions : 

r t 

|TERM | 
I DISK | 
| PRINTI 

L J 



•] 



. I 



where : 

GEN generates a CMS macro library. 

ADD adds members to an existing macro library. 

REP replaces existing members in a macro library. 

DEL deletes members from a macro library. 

COMP compacts a macro library. 

MAP lists certain information about the members in a macro 
library. Available information includes member name, size, 
and location relative to the beginning of the library. 

libname is the filename of a macro library. If the file already 
exists, it must have a filetype of MACLIB; if it is being 
created, it is given a filetype of MACLIB. 

fn1 [fn2... ] 

are the names of the macro definition files to be used. A 
macro definition file must reside on a CMS disk and its 
filetype must be either MACRO or COPY. Each file may contain 
one or more macros and must contain fixed-length, 80-character 
records. 

membernamel . . . 

is the name of a macro which exists in a macro library. 



HhR P.E£i2Ii§i: Tne following options specify where the output of the 
MAP function is sent. Only one option may be specified. If more 
than one option is specified, only the first one given is used. 



TERM 



displays the MAP output at the terminal. 
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I DISK writes the MAP output on a CMS disk with the file 

| identifier of 'libname MAP A1'. If a file with that name 

| already exists, the old file is erased. If no option is 

| specified, DISK is the default. 

| PRINT writes the file ■ libname MAP AT 1 to your A-disk and 
| spools a copy to the virtual printer. 

H§§3§ Notes 

1. When a MACRO file is added to a MACLIB, the membername is taken 
from the macro prototype statement. If there is more than one 
macro definition in the file,, each macro is written into a separate 
MACLIB member. 

If the filetype is COPY and the file contains more than one macro, 
each macro must be preceded by a control statement of the following 
format : 

♦COPY membername 

The name on the control statement is the name of the macro when it 
is placed in the macro library. If there is only one macro in the 
COPY file and it is not preceded by a COPY control statement, its 
name (in the macro library) is the same as the filename of the COPY 
file. If there are several macro definitions in a COPY file and 
the first one is not preceded by a COPY control statement the 
entire file is treated as one macro. 

2. If any MACRO file contains invalid records between members the 
MACLIB command display an error message and terminates. Any 
members read up until the invalid card is encountered are already 

| in the MACLIB. The MACLIB command ignores CATAL.S, END, and /* 
| records when it reads MACRO files created by the ESERV program. 

3. If you want a macro library searched during an assembly or 
compilation, you must identify it using the GLOBAL command before 
you begin compiling. 

4. The MACLIBs distributed with the CMS system are: CMSLIB, OSMACRO, 
0SMACR01, TSOMAC, and DOSMACRO. 

Responses 

When you enter the MACLIB MAP command with the TERM option, the names of 
the library members, their sizes, and locations in the library are 
displayed. 

iMACRO INDEX SIZE 
name loc size 



Other Messages and Return Codes 

DMSLEM001E NO FILENAME SPECIFIED RC=24 

| DMSLBM002E FILE »fn ft 1 NOT FOUND RC=28 

| DMSLBM002W FILE • f n ft [ f m ]« NOT FOUND RC=4 

DMSLBM003E INVALID OPTION 'option' RC=24 

DMSLBM013W MEMBER 'name' NOT FOUND IN LIBRARY • f n ft fm» RC=U 

DMSLBM014E INVALID FUNCTION 'function' RC=24 
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DMSLBM037E DISK 'mode' IS READ/ONLY RC=36 

DMSLBM046E NO LIBRARY NAME SPECIFIED RC=24 

DMSLBM047E NO FUNCTION SPECIFIED RC=24 

DMSLBM056E FILE ' f n ft fm» CONTAINS INVALID RECORD FORMATS RC=32 

DMSLBM070E INVALID PARAMETER 'parameter' RC=24 

DMSLBM104S ERROR 'nn« READING FILE • f n ft fm' FROM DISK RC=100 

DMSLBM105S ERROR • nn • WRITING FILE 'fn ft f m • ON DISK RC=100 

DMSLBM109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

DMSLBM157S MACLIB LIMIT EXCEEDED[ , LAST MEMBER NAME ADDED WAS 

' membername' ] RC=88 
DMSLBM167S PREVIOUS MACLIB FUNCTION NOT FINISHED RC=88 
DMSLBM213W LIBRARY • f n ft fm» NOT CREATED RC=4 
DMSLBM907T I/O ERROR ON FILE »fn ft f m • RC=256 
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Use the MODMAP command to display the load map associated with the 
specified MODULE file. The format of the MODMAP command is: 



j MODmap | fn I 



where : 

fn is the filename of the MODULE file whose load map is to be 
displayed. The filetype of the file must be MODULE; all of your 
accessed disks are searched for the specified file. 

Usacje Note 

I. You cannot issue a MODMAP command for modules that are CMS 
transient area modules or that have been created with the NOMAP 
option of the GENMOD command. 

Responses 

The load map associated with the file is displayed at the terminal, in 
the format: 

name location 



lE£°£ Messages and Return Codes 

DMSMDP001E NO FILENAME SPECIFIED RC=2U 
DMSMDP002E FILE «fn ft' NOT FOUND RC=28 
DMSMDP018E NO LOAD MAP AVAILABLE RC=40 
DMSMDP070E INVALID PARAMETER 'parameter 1 RC=24 
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MOVEFILE 

Use the MOVEFILE command to move data from any device supported by 
VM/370 to any other device supported by VM/370. The format of the 
MOVEFILE command is: 



r~ 



I r r t i 

| linddname |outddname| | 

MOVEfile || | I I [ (PDS[) ]] 

I IIIH2y.Ii I OUT MOVE | | 

I L L "" J J 



I 



w h er e : 

inddname is the ddname representing the input file definition. If 
ddname is not specified, the default input ddname, INMOVE, 
is used. 

outddname is the ddname representing the output file definition. If 
ddname is not specified, the default output ddname, OOTMOVE, 
is used. 

0£ t ion : 

PDS moves each of the members of the CMS MACLIB or TXTLIB or of 
an OS partitioned data set into a separate CMS disk file, 
with a filename equal to the member name and a filetype 
equal to the filetype of the output file definition. 

Usaqe Notes 

1. Use the FILEDEF command to provide file definitions for the ddnames 
used in the MOVEFILE command. If you use the ddnames INMOVE and 
OUTMOVE on the FILEDEF commands, then you do not need to specify 
them on the MOVEFILE command line. For example: 

filedef inmove disk sysl maclib b (member stow 

filedef outmove disk stow macro 

movefile 

copies the member STOW from the OS partitioned data set SYSL MACLIB 
into the CMS file STOW MACRO. 

If you enter 

filedef indd reader 
fileder outdd printer 
movefile indd outdd 

a file is moved from your virtual card reader to your virtual 
printer. 

2. To copy an entire OS partitioned data set into individual CMS 
files, you could enter 

filedef test2 disk sys 1 maclib b 
filedef macro disk 
movefile test2 macro (pds 

These commands copy members from the OS partitioned data set 
SYSL MACLIB or the CMS file SYS1 MACLIB into separate files, each 
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with a filename equal to the membername and a filetype of MACRO. 
Note that the output ddname was not specified in full, so that CMS 
assigned the default file definition (FILE ddname) . 

3. You cannot copy VSAM data sets with the MOVEFILE command. 

4. The MOVEFILE command does not support data containing spanned 
records. Use of spanned records results in the error message 
DMSSOP036E and an error code of 7. 



Default Device Attributes 



If a record f 
(LRECL) are s 
the data con 
operation, 
specification 
in Figure 15. 
is used. If 
logical recor 
F or U, the 
format is V, 



ormat (RECFM) , blocksize (BLOCK) , and logical record length 
pecified on the FILEDEF command, these values are used in 
trol block (DCB) defining the characteristics of the move 
If the FILEDEF was issued without the record format 
, that specification is taken from the default list shown 
If the blocksize was not specified, the default blocksize 
the logical record length was not specified, the default 
d length is determined as follows: if the record format is 
logical record length equals the blocksize; if the record 
the logical record length equals the blocksize minus 4. 




Disk file 



Dummy 



Input ddname 
RECFM | Blocksize 

F 
NA 2 
NA 2 



U 



RECFM of 
file 

NA 2 



NA 2 



80 


NA 2 


NA 2 


F 


NA 2 


U 


130 


U 


3600 


RECFM of 




input ddname 


Blocksize of 


RECFM of 


file 


input ddname 



Output ddname 
RECFM | Blocksize 
NA 2 
80 
132 
130 



Blocksize of 
input ddname 

Blocksize of 
input ddname 

Blocksize of 
input ddname 



RECFM of 
input ddname 



l If the default record format and blocksize are used in a 
tape-to— tape move operation and an input record is greater than 3600 
bytes, it is truncated to 3600 bytes on the output tape. 

2 Not applicable. 

Figure 15. Default Device Attributes for MOVEFILE Command 



DMSMVE225I PDS MEMBER •membername' MOVED 

The specified member of an OS partitioned data set was moved 
successfully to a CMS file. This response is issued for each 

member moved when you use the PDS option. 
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DMSMVE226I END OF PDS MOVE 

The last member of the partitioned data set was moved successfully 
to a CMS file. 

DMSMVE706I TERM INPUT — TYPE NULL LINE FOR END OF DATA 

The input ddname in the MOVEFILE specified a device type of 
terminal. This message requests the input data; a null line 
terminates input. 

DMSMVE708I DISK FILE 'FILE ddname A1 • ASSUMED FOR DDNAME 'ddname' 

No file definition is in effect for a ddname specified on the 
MOVEFILE command. The MOVEFILE issues the default FILEDEF command: 

FILEDEF ddname DISK FILE ddname A1 

If file ddname floes not exist for the input file, MOVEFILE 
terminates processing. 

Other Messages and Return Codes 

DMSMVE002E FILE »fn ft fm" NOT FOUND RC=28 

DMSMVE003E INVALID OPTION 'option 1 RC = 24 

DMSMVE037E OUTPUT DISK 'mode' IS READ/ONLY RC=36 

DMSMVE041E INPUT AND OUTPUT FILES ARE THE SAME RC=40 

DMSMVE070E INVALID PARAMETER 'parameter' RC=24 

DMSMVE073E UNABLE TO OPEN FILE ddname RC=28 

DMSMVE075E DEVICE 'device name' ILLEGAL FOR { INPUT | OUTPUT } RC=40 

DMSMVE086E INVALID DDNAME 'ddname' RC=24 

DMSMVE127S UNSUPPORTED DEVICE FOR ddname RC=100 

DMSMVE128S I/O ERROR ON INPUT AFTER READING nnnn RECORDS: INPUT ERROR 

code ON ddname RC=100 
DMSMVE129S I/C ERROR ON OUTPUT WRITING RECORD NUMBER nnnn: OUTPUT ERROR 

code ON ddname RC=100 
DMSMVE130S BLOCKSIZE ON V FORMAT FILE ddname IS LESS THAN 8 RC=88 
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I OPTION 



Use the OPTION command to change any or all of the options in effect for 
the DOS/VS COBOL compiler in CMS/DOS. The format of the OPTION command 
is: 



| OPTION 


[ options. . . ] 

o£t ions : 




















r t 

IDUMP | 
I NOD U MP | 

L " J 


r t 
|DECK | 
INODECK | 

L J 


r n 

|LIST | 
INOLISTI 

L J 


r t 
|LISTX | 
1 5 L I ST X | 

L J 


r t 
|SYM | 
1 5 OS Y M | 

L J 






r i 

IXREF | 
|NOXREF| 

L J 


r t 

|ERRS | 
|NOERRS| 

L J 


r n 
|U8C| 
|60C | 

L J 










i __——.,.. 


- — 




_„_____ 















_ 1 



Options: If an invalid option is specified on the command line, an 
error message is issued for that option; all other valid options are 
accepted. Only those options specified are altered, and all other 
options remain unchanged. 

DUMP dumps the registers and the virtual partition on the virtual 
SYSLST device in the case of abnormal program end. 

NODUMP suppresses the DUMP option. 

DECK punches the resulting object module on the virtual SYSPCH 

device. If you do not issue an ASSGN command for the logical 

unit SYSPCH before invoking the compiler, the text deck is 
written to your CMS A-disk. 

NODECK suppresses the DECK option. 

LIST writes the output listing of the source module on the SYSLST 
device. 

NCLIST suppresses the LIST option. This option overrides the XREF 
option as it does in DOS/VS. 

LISTX produces a procedure division map on the SYSLST device. 

NOLISTX suppresses the LISTX option. 

SYM prints a Data Division map on SYSLST. 

HOSYM suppresses the SYM option. 

XREF writes the output symbolic cross-reference list on SYSLST. 

MOMII suppresses the XREF option. 

ERRS writes an output listing of all errors in the source program 
on SYSLST. 

NOERRS suppresses the ERRS option. 

48C Uses the 48-character set. 

60C Uses the 60-character set. 
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I Ui*sl3§ Notes 

| 1. If you enter the OPTION conmand with no options, all options are 

I reset to their default values, that is, the default settings that 

| are in effect when you enter the CMS/DOS environment. CMS/DOS 

| defaults are not necessarily the same as the defaults generated on 

I the DOS/VS system being used and do not include additional options 

| that are available with some DOS compilers. 

| 2. The OPTION command has no effect on the DOS/VS PL/I compiler nor on 

I any of the OS language compilers in CMS. 

I Responses 

| None. To display a list of options currently in effect, use the QUERY 

I command with the OPTION operand. 

I Error !§ssages and Return Codes 

| DMSOPT070E INVALID PARAMETER •parameter 1 RC=24 

| DMSOPT099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 
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Use the PRINT command to print a CMS file on the spooled virtual 1403 or 
3211 printer. The format of the PRINT command is: 



PRint 



r t 

fn ft |fm| [ (options. ..[) ]] 

I* I 

L J 



r t 

options: |CC | 

|N0CC| 



r 
|LIl 



MEMBER 



[necoun / nn\ 
[UPCASE] | I 55 J 

L 

I * V 

\ membername )| [HEX] 



where : 

fn is the filename of the file to be printed. 

ft is the filetype of the file to be printed. 

fm is the filemode of the file to be printed. If this field is 
specified as an asterisk (*) , the standard order of search is 
followed and the first file found with the given filename and 
filetype is printed. If fm is not specified, the A-disk and its 
extensions are searched. 



Op t ion s : 
CC 



NOCC 



UPCASE 
UP 

MEMBER 
MEM 



interprets the first character of each record as a carriage 
control character. If the filetype is LISTING, the CC 
option is assumed. If CC is in effect, the PRINT command 
does not perform page ejects or count the number of lines 
per page; these functions are controlled by the carriage 
control characters in the file. The LINECOUN option has no 
effect if CC is in effect. 

does not interpret the first character of each record as a 
carriage control character. In this case, the PRINT 
command ejects a new page and prints a heading after the 
number of lines specified by LINECOUN are printed. If NOCC 
is specified, it is in effect even if CC was specified 
previously or if the filetype is LISTING. 



translates the lowercase 
uppercase for printing. 



letters 



in 



the 



file 



to 



HEX 



\ 

membername; 

prints the members of macro or text libraries. This option 
may be specified if the file is a simulated partitioned 
data set (filetype MACLIB or TXTLIB) . If * is entered, all 
individual members of that library are printed. If a 
membername is specified, only that member is printed. 

prints the file in graphic hexadecimal format. If HEX is 
specified, the options CC and UPCASE are not in effect, 
even if specified, and even if the filetype is LISTING. 
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LINECOON 



ill) 



allows you to set the number of lines to be printed on each 
page, nn can be any decimal number from through 99 and 
has a default value of 55. If nn is set to zero, the 
effect is that of an infinite line count and page ejection 
does not occur. This option has no effect if the CC option 
is also specified. 



Usage Notes 

1. The file may contain carriage control characters and may have 
either fixed- or variable-length records, but no record may exceed 
132 characters for a 1403 printer or 150 characters for a 3211 
printer. There are two exceptions: 

• If the CC option is in effect, the record length can be one 
character longer (133 or 151) to allow for the carriage control 
character. 

• If the HEX option is in effect, a record of any length can be 
printed, up to the CMS file system maximum of 65,535 bytes. 

2. If you want the first character of each line to be interpreted as a 
carriage control character, you must use the CC option. When you 
use the CC option for files that do not contain carriage control 
characters, the first character of each line is stripped off. 

Files with a filetype of UPDLOG (produced by the UPDATE command) 
must be printed with the CC option. 

3. One spool printer file is produced for each PRINT command, for 
example, 

print mylib maclib (member get 

prints the member GET from the file MYLIB MACLIB. If you want to 
print a number of files as a single file (so that you do not get 
output separator pages, for example) , use the CP command SPOOL to 
spool your virtual printer with the CONT option. 

Responses 

None. The CMS Ready message indicates the command completed without 
error (that is, the file is written to the spooled printer) . The file 
is now under the control of CP spooling functions. If a CP SPOOL 
command option such as HOLD or COPY is in effect, you may receive a 
message from CP. 

QtJjer Messages and Return Codes 

DMSPRT002E FILE • f n ft fm' NOT FOUND RC=28 

DMSPRT003E INVALID OPTION 'option 1 RC = 24 

DMSPRT008E DEVICE 'cuu' {INVALID OR NONEXISTENT (UNSUPPORTED DEVICE TYPE} 

RC=36 
DMSPRT013E MEMBER 'name* NOT FOUND IN LIBRARY RC=32 
DMSPRT029E INVALID PARAMETER 'parameter' IN THE OPTION 'option* FIELD 

RC = 24 
DMSPRT033E FILE 'fn ft f m • IS NOT A LIBRARY RC=32 
DMSPRT039E NO ENTRIES IN LIBRARY 'fn ft fro' RC=32 
DMSPRT044E RECORD LENGTH EXCEEDS ALLOWABLE MAXIMUM RC=32 
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DMSPRT048E INVALID MODE •mode' RC = 24 
DMSPRT054E INCOMPLETE FILEID SPECIFIED RC=24 
DMSPRT062E INVALID * IN FILEID RC=20 
DMSPRT070E INVALID PARAMETER 'parameter' RC=24 
DMSPRT10US ERROR »nn' READING FILE • f n ft fm' FROM DISK 
DMSPRT123S ERROR PRINTING FILE «fn ft f m • RC= 100 



RC=100 
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I PSERV 



Use the PSERV command in CMS/DOS to copy r display, print, or punch a 
procedure from the DOS/VS procedure library. The format of the PSERV 
command is: 



PSERV 



i 



r t 

procedure | ft | [ (options... [) ]] 
I PRO C | 

~C£1SK] [PRINT] 

[PUNCH] [TERM] 



where : 
procedure 

ft 



specifies the name of the procedure in the DOS procedure 
library that you want to copy, print, punch, or display. 

specifies the filetype of the file to be created on your 
A-disk. ft defaults to PROC if a filetype is net specified; 
the filename is always the same as the procedure name. 



Options: You may enter as many options as you wish, depending on the 
functions you want to perform. 

DISK copies the procedure to a CMS file. If no options are 
specified, DISK is the default. 

PRINT spools a copy of the procedure to the virtual printer. 

PUNCH spool a copy of the procedure to the virtual punch. 

TERM displays the procedure on your terminal. 

Osacje Notes 

1. You cannot execute DOS/VS procedures in CMS/DOS. You can use the 
PSERV command to copy an existing DOS/VS procedure onto a CMS disk, 
use the CMS Editor to change or add DOS/VS job control statements 
to it, and then spool it to the reader of a DOS/VS virtual machine 
for execution. 

2. The PSERV command ignores current assignments of logical units, and 
directs output according to the option list. 

Responses 

When you issue the TERM option, the procedure is displayed at your 
terminal . 



Section 2. CMS Commands 147 



PSERV 



I l££2I U§§saaes and Return Codes 

DMSPRV003E INVALID OPTION 'option' RC = 2H 

DMSPRV004E PROCEDURE 'procedure 1 NOT FOUND RC=28 

DMSPRV006E NO READ/WRITE 'A' DISK ACCESSED RC=36 

DMSPRV037E DISK 'A' IS READ/ONLY RC=36 

DMSPEV070E INVALID PARAMETER 'parameter' RC=24 

DMSPRV097E NO 'SYSRES' VOLUME ACTIVE RC=36 

DMSPRV098E NO PROCEDURE NAME SPECIFIED RC=24 

DMSPRV099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSPRV105S ERROR »nn» WRITING FILE • f n ft fm« TO DISK RC=100 

DMSPRV113S DISK (CUU) NOT ATTACHED RC=100 

DMSPRVU11S INPUT ERROR CODE »nn« ON 'SYSRES' RC=100 
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Use the PUNCH command to punch a CMS disk file to your virtual card 
punch. The format of the PUNCH command is: 



PUnch 



r t 
fn ft | fin | 

I* I 

L J 



[ (options. . .[) ]] 



ogti ons : 

r i 

| HEADER | 
|NOHEADER| 

L J 



MEMBER T* 



membername J | 

j 



where 
fn 

ft 



is the filename of the file to be punched, 
specified. 

is the filetype of the file to be punched, 
specified. 



This field must be 
This field must be 



fm is the filemode of the file to be punched. If you specify it as an 
asterisk (*) , the standard order of search is followed and the 
first file found with the specified filename and filetype is 
punched. If fm is not specified, your A-disk and its extensions 
are searched. 



Option s : 

HEADER 
H 



NOHEADER 
NCH 



MEMBER 
MEM 



I mem 



inserts a control card in front of the punched output. 
This control card indicates the filename and filetype for 
a subsequent READCARD command to restore the file to a 
disk. The control card format is shown in Figure 16. 

does not punch a header control card. 



bername / 
punches members of MACLIBs or TXTLIBs. If * is entered, 
all individual members of that macro or text library are 
punched. If membername is specified, only that member is 
punched. If the filetype is MACLIB and the MEMBER 
membername option is specified, the header contains 
MEMBER as the filetype. If the filetype is TXTLIB and 
the MEMBER membername option is specified, the header 
card contains TEXT as the filetype. 
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Number of 




Column 


Characters 


Contents 


1 


1 


: 


2-5 


4 


| READ 


6-7 


2 


Iblank 


8-15 


8 


If name 


16 


1 


blank 


17-24 


8 


if type 


25 


1 


blank 


26-27 


2 


f mode 


28 


1 


blank 


29-34 


6 


volid 


35 


1 


blank 


36-43 


8 


mm/dd/yy 


44-45 


2 


blank 


46-50 


5 


hh :mm 


51-80 


30 


blank 



Meaning 

Identifies card as a control card. 
Ildentifies card as a READ control card. 

Filename of the file punched. 

IFiletype of the file punched. 

IFilemode of the file punched. 



ILabel of the disk from which the file was 
read. 



The date that the file was last written. 



The time of day that the file was written 
to disk . 



Figure 16. Header Card Format 



Usacje Notes 

1. You can punch fixed- or variable-length records with the PUNCH 
command, as long as no record exceeds 80 characters. Records with 
less than 80 characters are right-padded with blanks. Records 
longer than 80 characters are rejected. 

2. If you punch a MACLIB or TXTLIB file specifying MEMBER *, a read 
control card is placed in front of each library member. If you 
punch a library without specifying the MEMBER option, only one read 
control card is placed at the front of the deck. 

3. One spool punch file is produced for each PUNCH command, for 
example : 

punch compute assemble (noh 

punches the file COMPUTE ASSEMBLE, without inserting a header 
card. To transmit multiple CMS files as a single punch file, use 
the CP SPOOL command to spool the punch with the CONT option. 

Responses 

None. The CMS Ready message indicates if the command completed without 
error (the file was successfully spooled) ; the file is now under control 
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of CP spooling functions. You may receive a message from CP indicating 
that the file is being spooled to a particular user's virtual card 
reader. 

Q£]l§£ Messages and Return Codes 

DMSPUN002E FILE »fn ft fm' NOT FOUND RC=2 8 

DMSPUN003E INVALID OPTION 'option 1 RC=2U 

DMSPUN008E DEVICE 'cuu' {INVALID OR NONEXISTENT (UNSUPPORTED DEVICE TYPE} 

RC=36 
DMSPUN013E MEMBER 'name' NOT FOUND IN LIBRARY RC=32 
DMSPUN033E FILE «fn ft fm' IS NOT A LIBRARY RC=32 
DMSPUN039E NO ENTRIES IN LIBRARY • f n ft f m • RC=32 
DMSPUN044E RECORD LENGTH EXCEEDS ALLOWABLE MAXIMUM RC=32 
DMSPUN054E INCOMPLETE FILEID SPECIFIED RC=2U 
DMSPUN062E INVALID * IN FILEID RC=20 

DMSPUN104S ERROR «nn« READING FILE 'fn ft f m ' FROM DISK RC=100 
DMSPUN118S ERROR PUNCHING FILE • f n ft fm» RC=100 
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QUERY 

Use the QUERY command to gather information about your CMS virtual 
machine. You can determine: 

• The state of virtual machine characteristics that are controlled by 
the CMS SET command. 

[ • File definitions (set with the FILEDEF and DLBL commands) that are in 
effect. 

• The status of accessed disks. 

| • The status of CMS/DOS functions. 

The format of the QUERY command is: 



Query 



BLIP 

RDYMSG 

LDRTBLS 

RELPAGE 

IMPCP 

IMPEX 

ABBREV 

REDTYPE 

PROTECT 

INPUT 

OUTPUT 

SYSNAMES 

SEARCH 

DISK 



jaodej 



(system 
synonym \ user 
(all 

FILEDEF 
MACLIB 
TXTLIB 
LIBRARY 

SIS/DOS Functions: 

DLBL 

DOS 

DOSLIB 

DOSPART 

OPTION 

UPSI 



i 



0£6£ands for Functions that can be Controlled via the SET Command 
BLIP displays the BLIP character (s) . 
ResjDonse: BLIP = (xxxxxxxx 



( xxxxxxxx | 

\OFF / 
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RDYMSG displays the RDYMSG message of the CMS Ready format, 

Response: RDYMSG = (LMSG) 

(SMSGJ 

where : 

LMSG is the standard CMS Ready message: 

R; T = 0. 12/0.33 17:06:20 

SMSG is the shortened CMS Ready message: 

R; 

LDRTBLS displays the number of loader tables. 
Response: LDRTBLS = nn 



RELPAGE 



IMPCP 



indicates whether pages of storage are to be released or 
retained after certain commands complete execution. 



Response: RELPAGE = 
where: 



JON ) 
(OFF/ 



ON releases pages. 
OFF retains pages. 

displays the status of implied CP command indicator. 

Response: IMPCP = (ON ) 

(OFF) 

where : 

ON indicates that CP commands can be entered from the CMS 

environment. 
OFF indicates that you must use the CP command or the #CP 

function to enter CP commands from the CMS 

environment. 



IMPEX displays status of implied EXEC indicator. 

Response: IMPEX = ( ON \ 

(OFF J 

where: 

ON indicates that EXEC files can be executed by entering 

the filename of the file. 
OFF indicates that the EXEC command must be explicitly 

entered to execute EXEC files. 

ABBREV displays the status of the minimum truncation indicator. 

Response: ABBREV = j ON \ 

(OFF j 
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where : 

ON indicates that truncations are accepted for CMS 

commands. 
OFF indicates that truncations are not accepted. 

REDTYPE displays the status of the REDTYPE indicator. 

Response: REDTYPE = TON \ 

\OFFJ 

where: 

ON types CMS error messages in red r for certain terminals 
equipped with the appropriate terminal feature and a 
two-color ribbon. Supported terminals are described in 
the VM,/37(): Terminal User^s Guide. 

OFF does not type CMS error messages in red. 

PROTECT displays the status of CMS nucleus protection. 

Response: PROTECT = (ON ) 

\ OFF / 

where : 

ON means CMS nucleus protection is in effect. 
OFF means CMS nucleus protection is not in effect. 

INPUT displays the contents of any input translate table in effect. 
Response: INPUT a1 xx1 

an xxn 

If you do not have an input translate table in effect, the 
response is 

NO USER DEFINED INPUT TRANSLATE TABLE IN USE 

OUTPUT displays the contents of any output translate table in 
effect. 

Response: OUTPUT xx1 a1 



xxn an 

If you do not have an output translate table defined, the 
response is 

NO USER DEFINED OUTPUT TRANSLATE TABLE IN USE 

I SYSNAMES displays the names of the saved system currently being used by 
J your virtual machine. 
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| Resjaonse: SYSNAMES: CMSSEG CMSVSAM CMSAMS CMSDOS 

| ENTRIES: entry... entry... entry... entry... 

I Ull^re: 

| SYSNAMES are the standard names associated with the 

| discontiguous saved systems. 

| ENTRIES are the names of the saved systems being used. 

0£§£^nds for CMS Disk Status Functions: 

SEARCH displays the search order of all disks currently accessed. 



r i 

OS | 
DOS | 



Response: label cuu mode/R/O) j— OS 

t R/Wj |-D 



where: 



label is the label assigned to the disk when it was 
formatted; or, if it is an OS or DOS disk, the volume 
label. 

cuu is the virtual device address. 

mode is the filemode letter assigned to the disk when it was 
accessed. 

( R/0 ) indicates the read/write status. 
I R/W) 

r t 

| OS | indicates an OS or DOS disk. 
| DOS | 

L J 

DISK mode displays the status of the single disk represented by 'mode 1 . 

Response: mode (cuu) : nnnn FILES, nnnnn REC IN USE, nnnnn LEFT 
(of nnnnn), nn% FULL (nnn CYL) , type /R/0\ 

\R/Wj 

If the disk is an OS or DOS disk, the response is: 

mode (cuu): (nnn CYL), type, fR/0\-(OS \ 

I R/W J I DOS J 
where : 

mode (cuu) are the access mode letter and virtual device 
address. 

nnnn FILES is the number of CMS files on the disk. 

nnnnn REC IN USE, nnnnn LEFT (of nnnnn) 

indicates the number of CMS 800— byte blocks in 
use. 

nnX FULL (nnn CYL) 

indicates the percentage of total use and the 
number of cylinders. 
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| (R/0\ indicates the read/write status. 

indicates an OS or DOS disk. 




If the disk with the specified mode is not accessed, the 
response is 

DISK •mode 1 NOT ACCESSED 

DISK * displays the status of all CMS disks. 

Response: same as for QUERY DISK mode; one line is displayed 
for each accessed disk. 



Other Functions: 



SYNONYM SYSTEM 

displays the CMS system synonyms in effect, 

Response: SYSTEM SHORTEST 
COMMAND FORM 



command minimum truncation 



If no system synonyms are in effect, the following message is 
displayed at the terminal: 

NO SYSTEM SYNONYMS IN EFFECT 



SYNONYM USER 

displays user synonyms in effect. 

Response: SYSTEM USER SHORTEST 

COMMAND SYNONYM FORM (IF ANY) 



command synonym minimum truncation 



If no user synonyms are in effect, the following message is 
displayed at the terminal: 

NO USER SYNONYMS IN EFFECT 

SYNONYM ALL 

displays all synonyms in effect. 

Response: The response to the command QUERY SYNONYM SYSTEM is 
followed by the response to QUERY SYNONYM USER. 
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FILEDEF displays all file definitions in effect. 
Response: ddnarae device [fn [ft]] 



If no file definitions are in effect, the following message is 
displayed at the terminal: 

NO USER DEFINED FILEDEF' S IN EFFECT 



MACLIB displays the names of all files, with a filetype of MACLIB, 
that are to be searched for macro definitions (that is, all 
MACLIBs specified on the last GLOBAL MACLIB command, if any) . 



Response: MACLIB = libname... 

If no macro libraries are 
definitions, the response is: 

MACLIB = NONE 



to be searched for macro 



TXTLIB displays the names of all files, with a filetype of TXTLIB, 
that are to be searched for unresolved references (that is, 
all TXTLIBs specified on the last GLOBAL TXTLIB command, if 
any) . 

Response: TXTLIB = libname... 

If no TXTLIBs are to be searched for unresolved references, 
the following message is displayed at the terminal: 

TXTLIB = NONE 



| LIBRARY displays the names of all library files with filetypes of 
| MACLIB, TXTLIB, DOSLIB that are to be searched. 

Response: MACLIB = (libname... | 

(NONE f 

TXTLIB = f libname... 
\ NONE 



DOSLIB = 



} 

( libname. . . "I 
\ NONE J 



I C MS-DOS Functions: 

| DLBL displays all disk file definitions in effect, 

I Response: ddname DISK fn ft 

| .... 



If no DLBL definitions are in effect, the following message is 
displayed: 

NO USER DEFINED DLBL«S IN EFFECT 
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I DOS displays whether the CMS/DOS environment is active or not. 

J Res£onse: DOS = ( ON ) 

I ~ \OFFJ 

| DOSLIB displays the names of all files with a filetype of DOSLIB that 
I are to be searched for executable phases (that is, all DOSLIBs 

| specified on the last GLOBAL DOSLIB command, if any) . 

8 li~S£onse: DOSLIB = (libname • • . 1 

I (NONE / 

| DOSPART displays the current setting of the virtual partition size. 

I R< 



*.§S£onse: j nnnnnK ) 
\NONE J 



1 where : 

I nnnnnK indicates the size of the virtual partition to be used 

J at program execution time. 

| NONE indicates that CMS determines the virtual partition 

I size at program execution time. 

| OPTION displays the compiler options that are currently in effect. 

I £es£onse: OPTION = options... 

| UPSI displays the current setting of the UPSI byte. The eight 
| individual bits are displayed as zeros or ones depending on 

| whether the corresponding bit is on or off. 

I l£:§£onse; UPSI = nnnnnnnn 

Usage Notes 

1. You can specify only a QUERY command function at one time. If the 
implied CP function is in effect and you enter an invalid QUERY 
command operand, you may receive the message DMKCQG045E. 

| 2. The DOSPART, OPTION, and UPSI operands are valid only if the 
| CMS/DOS environment is active. 

MLL2L H§§§ages and Return Codes 

DMSQRY005E NO "option' SPECIFIED RC=2U 

DMSQRY014E INVALID FUNCTION 'function' RC=24 

DMSQRY026E INVALID PARAMETER 'parameter' FOR 'function' FUNCTION RC=24 

DMSQRY047E NO FUNCTION SPECIFIED RC=2U 

DMSQRY070E INVALID PARAMETER 'parameter' RC=24 

| DMSQRY099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 



158 IBM VM/370: CMS Command and Macro Reference 



READCARD 



READCARD 



Use the READCARD command to read data records from your virtual card 
reader and to create CMS disk files containing the data records. The 
format of the READCARD command is: 







r t 

fn ft | fm | 

i h I 

L J 

r r n 

* | * | fm | | 

I I A | | 

L L J J 



where : 
fn 
ft 
* [* ] 

fm 



is the filename you want to assign to the file being read. 

is the filetype you want to assign to the file being read. 

indicates that file identifiers are to be assigned according 
to READ control cards in the input deck. 

is the filemode of the disk onto which the file is to be read. 
If this field is omitted or specified as an asterisk (*) , the 
A-disk is assumed. Whenever a mode number is specified on the 
command line, it is used. Otherwise, the mode number on the 
READ control card is used to create the disk file. 



Osa^e Notes 

1. Data records read by the READCARD command must be fixed- length, and 
may be a minimum of 80 and a maximum of 151 characters long. 

2. CMS disk file identifiers are assigned according to READ control 
cards in the input deck (the PUNCH command header card is a valid 
READ control card) . When you enter the command 

readcard * 

CMS reads the first spool reader file in the gueue and if there are 
READ control cards in the input stream, it names the files as 
indicated on the control cards. 

If the first card in the deck is not a READ control card, CMS 

writes a file named READCARD CMSUT1 A1 to contain the data, until a 

READ control card is encountered or until the end-of-file is 
reached. 

3. If you specify a filename and filetype on the READCARD command, for 
example, 

readcard junk file 

CMS does not check the input stream for READ control cards, but 
reads the entire spool file onto disk and assigns it the specified 
filename and filetype. 

If there were any READ control cards in the deck, they are not 
removed; you must delete them using the CMS Editor if you do not 
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want them in your file. If the file is too large, you can either 
increase the size of your virtual storage (using the CP DEFINE 
command) , or use the COPYFILE command to copy all records except 
the READ control cards (using the FROM and FOR options) . 

H. To read file onto a disk other than your A-disk, you can specify 
the filemode letter when you enter the filename and filetype, for 
example: 

readcard junk file c 

Or, if you want READ control card to determine the filenames and 
filetypes, you can enter 

readcard * * c 

5. When you read a file that has the same filename and filetype of an 
existing file on the same disk, the old file is replaced. 

6. If you are preparing real or virtual card decks to send to your own 
or another user's virtual card reader, you may insert READ control 
cards to designate filenames and filetypes, and optionally filemode 
numbers, to be assigned to the disk f ile (s) . 

A READ control card must begin in column 1 and has the format: 

:READ filename filetype filemode 

Each field must be separated by at least one blank; the second 
character of the filemode field, if specified, must be a valid 
filemode number (0 through 5) . The filemode letter is ignored when 
this file is read, since the mode letter is determined by 
specifications on the READCARD command line. 

7. To send a real card deck to your own or another user's virtual card 
reader, you must punch a CP ID card in the front of the deck. The 
ID card has the keyword ID or USERID in column 1, followed by the 
userid you want to receive the file, and optionally spool file 
class and name designations, for example: 

ID CONCARNE CLASS A NAME CHILI PEPPER 

Each field must be separated from the others by at least one 
blank. 

Responses 

When the command READCARD * is issued, control cards encountered in the 
input card stream are displayed at the terminal (see message 
DMSRDC702I) , to indicate the names assigned to each file. 

DMSRDC701I NULL FILE 

The spooled card reader contains no records after the control 
card . 

DMSRDC702I :READ filename filetype fn (other information) 

A READ control card has been processed; the designated file is 
being written on disk. 
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DMSRDC702I READ CONTROL CARD IS MISSING. FOLLOWING ASSUMED: 
DMSRDC702I :READ READCARD CMSUT1 A1 

The first card in the deck is not a READ control card. Therefore, 
the file READCARD CMSUT1 A1 is created. 

DMSRDC738I RECORD LENGTH IS "nnn" BYTES 

The records being read are not 80 bytes long; this message gives 
the length. 

Other Messages and Return Codes 

DMSRDC008E DEVICE »cuu» {INVALID OR NONEXISTENT IUNSUPPORTED DEVICE TYPE} 

RC=36 
DMSRDC042E NO FILEID SPECIFIED RC=24 
DMSRDC054E INCOMPLETE FILEID SPECIFIED RC=24 
DMSRDC062E INVALID * IN FILEID RC=20 

DMSRDC105S ERROR »nn» WRITING FILE • f n ft fm* ON DISK RC=100 
DMSRDC12US ERROR READING CARD FILE RC=100 
DMSRDC205W READER EMPTY OR NOT READY RC=8 
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Use the RELEASE command to free an accessed disk and make the files on 
it unavailable. The format of the RELEASE command is: 



| | RELease | 
I I 

where: 



( cuu ) [ (DET[ ) ] 3 
\ mode J a 



cuu is the virtual device address of the disk that is to be 
released. 

| Valid addresses are 001 through 5FF for a virtual machine in 
| basic control mode and 001 through FFF for a virtual machine in 
| extended control mode. 

mode is the mode letter at which the disk is currently accessed. 

I Ofiiion : 

I DET specifies that the disk is to be detached from your virtual 
| machine configuration, CMS calls the CP command DETACH. 

Usage Notes 

1. If a disk is accessed at more than one mode letter, the RELEASE cuu 
command releases all modes. If you access a disk specifying the 
mode letter of an active disk, the first disk is released. 

2. You cannot release the system disk (S-disk) . 

3. When a disk is released, the user file directory is freed from 
storage and that storage becomes available for other CMS commands 
and programs. When you release a read/write CMS disk, either with 
the RELEASE command or implicitly with the FORMAT command, the user 
file directory is sorted and rewritten on disk; user (s) who may 
subsequently access the same disk may have a resultant favorable 
decrease in file search time. 

4. When a disk is released, any read-only extensions it may have are 
not released. The extensions may be referred to by their own mode 
letters. If a disk is then accessed with the same mode as the 
original parent disk, the original read-only extensions remain 
extensions to the new disk at that mode. 

5. In CMS/DOS, when you release a disk, any system or programmer 
logical unit assignments made for the disk are unassigned. 

Responses 

DASD CUU DETACHED 

This is a CP message that is issued when you use the DET option. 
It indicates that the disk has been detached. 
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MLE2E Hf-ssages lliSl Return Codes 

DMSARE017E INVALID DEVICE ADDRESS 'CUU« RC=24 

DMSARE028E NO DEVICE SPECIFIED RC=2U 

DMSARE048E INVALID MODE 'mode* RC=2U 

DMSARE069E DISK { 'mode* | •cuu 1 } NOT ACCESSED RC=36 

DMSARE070E INVALID PARAMETER •parameter 1 RC=2U 
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Use the RENAME command to change the fileid of one or more CMS files on 
a read/write CMS disk. The format of the RENAME command is: 



Rename | fileidl fileid2 [ (options. ..[) ]] 

opt ion s : 

r i r t 
| TYPE | IOPDIRT | 
|NOTYPE| | NO OP DIRT | 

L J L J 



where : 
fileidl 



fileid2 



is the file identifier of the original file whose name is to 
be changed. All components of the fileid (filename, 
filetype, and filemode) must be coded, with either a name or 
an asterisk. If an asterisk is coded in any field, any file 
that satisfies the other gualifications is renamed. 

is the new file identifier of the file. All components of 
the file (filename, filetype, and filemode) must be coded, 
with either a name or an egual sign; if an egual sign (=) is 
coded, the corresponding file identifier is unchanged. The 
output filemode can also be specified as an asterisk (*) , 
indicating that the filemode is not changed. 



Option s : 

TYPE 
T 



NO TYPE. 
NOT 

UPDIRT 

up" 
ncupdirt 

NO UP 



displays, at the terminal, the new identifiers of all 
the files that are renamed. The file identifiers are 
displayed only when an * is specified for one or more of 
the file identifiers (fn, ft or fm) in fileidl. 

suppresses displaying, at the terminal, of the new file 
identifiers of all files renamed. 

updates the master file directory upon completion of this 
command. 

suppresses the updating of the master file directory 
upon completion of this command. (See Osage Note 3.) 



Usage Notes 

1. When you code an asterisk in any portion of the input fileid, any 

or all of the files that satisfy the other gualifiers may be 

renamed, depending on how you specify the output fileid. For 
example, 

rename * assemble a test file a 

results in the first ASSEMBLE file found on the A-disk being 
renamed to TEST FILE. If more than one ASSEMBLE file exists, error 
messages are issued to indicate that they cannot be renamed. 
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If you code an equal sign in an output fileid in a position 
corresponding to an asterisk in an input fileid , all files that 
satisfy the condition are renamed. For example, 

rename * assemble a = oldasm = 

renames all files with a filetypes of ASSEMBLE to files with a 
filetype of OLDASM. Current filenames are retained. 

2. You cannot use the RENAME command to move a file from one disk to 
another. You must use the COPYFILE command if you want to change 
filemode letters. 

You can use the RENAME command to modify filemode numbers, for 
example, 

rename * module a1 = = a2 

changes the filemode number on all MODULE files that have a mode 
number of 1 to a mode number of 2. 

3. Normally, the master file directory for a CMS disk is updated 
whenever you issue a command that affects files on the disk. When 
you use the NOUPDIRT option of the RENAME command, the master file 
directory is not updated until you issue a command that writes, 
updates, or deletes any file on the disk, or until you explicitly 
release the disk (with the RELEASE command) . 

Responses 

newfn newft newfm 

The new filename, filetype, and filemode of each file altered is 
displayed when the TYPE option is specified and an asterisk was 
specified for at least one of the file identifiers (fn, ft or fm) 
of the input fileid. 

MLLQE H©ssa<jes and Return Codes 

DMSRNM002E FILE «fn ft fm 1 NOT FOUND RC=28 
DMSRNM003E INVALID OPTION 'option 1 RC=24 
DMSRNM019E IDENTICAL FILEIDS RC=24 
DMSRNM02UE FILE • f n ft fm« ALREADY EXISTS RC=28 
DMSRNM030E FILE »fn ft fm 1 ALREADY ACTIVE RC=28 
DMSRNM037E DISK »mode(cuu)» IS READ/ONLY RC=36 
DMSRNM051E INVALID MODE CHANGE RC=24 
DMSRNM054E INCOMPLETE FILEID SPECIFIED RC=2U 
DMSRNM062E INVALID * IN OUTPUT FILEID RC=20 

Note: You can invoke the RENAME command from the terminal, from an EXEC 
file, or as a function from a program. If RENAME is invoked as a 
function or from an EXEC file that has the 8C0NTR0L NOMSG option in 
effect, the message DMSRNM002E FILE fn ft fm NOT FOUND is not issued. 
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1 RSERV 



I Use the RSERV command in CMS/DOS to copy, display, print, or punch a 
I DOS/VS relocatable module from a private or system library. The format 
| of the RSERV command is: 




r t 

modname | ft | [ (options. ..[ ) ]] 
I HIT | 
L J 2E t i o ns : 

[ DISK ] 
[PUNCH 



[ PRINT] 
[ TERM] 



I where :: 

j modname 
I 

| ft 



specifies the name of the module on the DOS/VS private or 
system relocatable library. 

specifies the filetype of the file to be created on your 
A-disk. ft defaults to TEXT if a filetype is not specified. 
The filename is always the same as the module name. 



Options: You may specify as many options as you wish on the RSERV 
command, depending on which functions you want to perform. 

DISK copies the relocatable module onto your A-disk. If no other 
options are specified, DISK is the default. 

PUNCH punches the relocatable module on the virtual punch. 

PRINT prints the relocatable module on the virtual printer. 

TERM displays the relocatable module at your terminal. 

M§§36 Notes 

I. If you want to copy modules from a private relocatable library, you 
must issue an ASSGN command for the logical unit SYSRLB and 
identify the library on a DLBL command line using the ddname 
IJSYSRL. 

To copy modules from the system relocatable library, you must have 
entered the CMS/DOS environment specifying a mode letter on the SET 
DOS ON command line. 



The RSERV command ignores the assignment of logical units, 
directs output to the devices specified on the option list« 



and 



Responses 

If you use the TERM option, the relocatable module is displayed at the 
terminal. 
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I i?§ssac[es and Return Codes 

DMSRRV003E INVALID OPTION •option 1 RC=2U 

DMSRRV004E MODULE •module" NOT FOUND RC=28 

DMSRRV006E NO READ/WRITE 'A 1 DISK ACCESSED RC=36 

DMSRRV070E INVALID PARAMETER 'parameter' RC=2U 

DMSRRV097E NO 'SYSRES' VOLUME ACTIVE RC=36 

DMSRRV098E NO MODULE NAME SPECIFIED RC=24 

DMSRRV099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSRRV105S ERROR • nn • WRITING FILE 'fn ft f m • ON DISK RC=100 

DMSRRV113S DISK (cuu) NOT ATTACHED RC=100 

DMSRRV411S INPUT ERROR CODE • nn ' ON '{ SYSRES | SYSRLB }• RC=100 
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Use the RUN EXEC procedure to initiate a series of functions on a file. 
The RUN command can compile, load r and start execution of the specified 
file, depending upon the filetype. The format of the RUN command is: 



I RUN | fn [ft [fm]] [ (args...[) ]] 



where: 



fn 



is the filename of the file to be manipulated 



ft is the filetype of the file to be manipulated. If filetype is not 
specified, a search is made for a file with the specified filename 
and the filetype of EXEC, MODULE, or TEXT (the search is performed 
in that order) . If the filetype of an input file for a language 
processor is specified, the language processor is invoked to 
compile the source statements and produce a TEXT file. Then, LOAD 
and START are called to initiate program execution. The valid 
filetypes and resulting action for this command are: 



Filetype 
EXEC 

MODULE 



TEXT 



FORTRAN 



Action 

The EXEC processor is called to process the file. 

The LOADMOD command is issued to load the program into 
storage and the START command begins execution of the 
program at the entry point equal to fn. 

The LOAD command brings the file into storage in an 
executable format and the START command executes the 
program beginning at the entry point named by fn. 

The FORTRAN processor module that is called is FORTRAN, 
FORTGI, GOFORT, TESTFORT, or FORTHX, whichever is found 
first . 



FREEFORT 
COBOL 



PLI 
PLIOPT 



The GOFORT module is called to process the file. 

The COBOL processor module that is called is COBOL or 
TESTCOB, whichever is found first. 



The PLIOPT processor module is called to 
the file. 



process 



fm is the filemode of the file to be manipulated. If this field is 
specified, a filetype must be specified. If fm is not specified, 
the default search order is used to search your disks for the 
file. 

args are arguments you want to pass to your program. You can specify up 
to 13 arguments in the RUN command, provided they fit on a single 
input line. Each argument is left- justified, and any argument more 
than 8 characters long is truncated on the right. 
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Osage Notes 

1 . The RUN command is an EXEC procedure; if you want to execute it 
from within an EXEC, you must use the EXEC command. 

2. If you are executing an EXEC file, the arguments you enter on the 
RUN command line are assigned to the variable symbols &1, &2, and 
so on. 

If you are executing a TEXT or MODULE file, or compiling and 
executing a program, the arguments are placed in a parameter list 
and passed to your program when it executes. The arguments are 
placed in a series of doublewords in storage, terminated by X^F 1 . 
If you enter 

run myprog (charlie dog 

the arguments CHARLIE and DOG are placed in a parameter list, and 
the address of the list is in Register 1 when your program receives 
control. 

Note: You cannot use the argument list to override default options 
for the compilers or for the LOAD or START commands. 

3. The RUN command is not designed for use with CMS/DOS. 

Responses 

Any responses are from the programs or procedures that executed within 
the RUN EXEC. 

Error Messages and Return Codes 

DMSRUN001E NO FILENAME SPECIFIED RC=24 
| DMSRUN002E FILE['fn [ft [fm]]»] NOT FOUND RC=28 

DMSRUN048E INVALID MODE 'fm* RC=24 

DMSRUN070E INVALID PARAMETER 'parameter 1 RC=24 
| DMSRUN999E NO [ft] PROCESSOR FOUND RC=28 
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Use the SET command to establish, turn off, or reset a particular 
function in your CMS virtual machine. Only one function may be 
specified per SET command. The format of the SET command is: 



SET 



function 

r t 

f]?£ctions: |BLIP string[ (count) ]| 

| BLIP ON | 

IBLIP OFF | 

L J 



[LDBTBLS nn] 



r i 

IABBREV ON | 
IAEBREV OFF | 

IL J 

r i 

IIMPCP ON | 
IIMPCP OFF| 

L J 



r t 

I 1ILP AGE ON | 

IRELPAGE OFF | 

L J 



r t 

IREDTYPE ON | 

IREDTYPE OFF | 

L J 

r t 

| PROTECT ON j 

| PROTECT OFF | 

L J 



r (CMSDOS ) t 
ISYSNAME JCMSVSAm( entryname | 

| )CMSAMS ( | 

^ (cMSSEG ) J 

CMS/EOS functions: 

r i r 

|DOS ON [mode [ (VSAM[)]]]| | UPSI 

| DOS OFF | I UPSI 

L J L 



r i 

IRDYMSG LMSG| 
IRDYMSG SMSG| 

L J 



r r it 

| INPUT | a xx | | 

I Ixx yyl I 

L L J J 

[OUTPUT [xx a] ] 

r l 

IIMPEX ON | 
IIMPEX OFF | 

%. j 

r t 

IAUTOREAD ON | 
IAUTOREAD OFF | 

L J 



r (CMSDOS \ t 

INONSHARE JcMSVSAMf | 
| JCMSAMS / | 

•- (CMSSEG ) J 



t r t 

nnnnnnnnl |DOSPART nnnnnK | 

OFF | IDOSPART OFF | 

— J L "" J 



where : 

Functions : 

BLIP string[ (count) ] 

defines the characters which are displayed at the 
terminal to indicate every two seconds of virtual 
interval timer time. This time is made up of virtual 
CPU time plus, if the REALTIMER option on, self-imposed 
wait time. 

You can define up to 8 characters as a blip string; if 
you want trailing blanks, you must specify count. ON 
and OFF must not be used as BLIP characters. 



BLIP ON 



sets the BLIP character string to its default, which is 
a string of nonprintable characters. ON is the default 
for typewriter devices. The default BLIP character 
provides no visual or audio-visual signal on a 3767 
terminal. You must define a BLIP character for a 3767 if 
you want the BLIP function. 



BLIP OFF 



turns off 
devices. 



BLIP. OFF is the default for graphics 
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S5IMSG LMSG indicates that the standard CMS Ready message, including 
current and elapsed time, is used. The format of the 
standard Ready message is: 

R; T=s.mm/s.mm hh:mm:ss 

where the virtual CPU time, real CPU time, and clock 
time are listed. 

RDYMSG SMSG indicates that a shortened form of the CMS Ready message 
(R;) which does not include the time, is used. 

LDRTBLS nn defines the number (nn) of pages of storage to be used 
for loader tables. By default, a virtual machine having 
up to 384K of addressable real storage has two pages of 
loader tables; a larger virtual machine has three 
pages. Each loader table page has a capacity of 204 
external names. During LOAD and INCLUDE command 
processing, each unigue external name encountered in a 
TEXT deck is entered in the loader table. The LOAD 
command clears the table before reading TEXT files; 
INCLUDE does not. This number can be changed with the 
SET LDRTBLS nn command provided that: (1) nn is a 
decimal number less than 128, (2) the virtual machine 
has enough storage available to allow nn pages to be 
used for loader tables, and (3) the system has not 
started using storage located below the LDRTBLS. If 
these three conditions are met, nn pages are set aside 
for loader tables. If you plan to change the number of 
pages allocated for loader tables, you should do so as 
soon after IPL as possible. 

HiliGE ON releases page frames of storage and sets them to binary 
zeros after the following commands complete execution: 
ASSEMBLE, COPYFILE, COMPARE, EDIT, MACLIB, SORT, TXTLIB, 
UPDATE, and the program product language processors 
supported by VM/370. These processors are listed in the 
XMZ3.70: Introduction. 

RELPAGE OFF does not release pages of storage after the commands 
listed in the RELPAGE ON description complete 
execution. Use the SET RELPAGE OFF function when 
debugging or analyzing a problem so that the storage 
used is not released and can be examined. 

INPUT a xx translates the specified character •a* to the specified 
hexadecimal code xx for characters entered from the 
terminal. 

INPUT xx yy allows you to reset the hexadecimal code xx to the 
specified hexadecimal code yy in your translate table. 

Note: If you issue SET INPUT and SET OUTPUT commands for 
the same characters, issue the SET OUTPUT command 
first. 



INPUT 
OUTPUT xx a 

OUTPUT 



returns all characters to their default translation. 

translates the specified hexadecimal representation xx 
to the specified character 'a 1 for all xx characters 
displayed at the terminal. (X'00 1 is not translated.) 

returns all characters to their default translation. 
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Note: Output translation does not occur for SCRIPT files 
when the SCRIPT command output is directed to the 
terminal, nor when you use the CMS Editor on a display 
terminal in display mode. 

1111IY. ON accepts system and user abbreviations for system 
~* commands. The SYNONYM command makes the system and user 

abbreviations available. 

ABBREV OFF accepts only the full system command name or the full 
user synonym (if one is available) for system commands. 

For a discussion of the relationship of the SET ABBREV 
and SYNONYM commands, refer to the SYNONYM command 
description. 

EMTIJPJ ON types CMS error messages in red for certain terminals 
equipped with the appropriate terminal feature and a 
two-color ribbon. Supported terminals are described in 
the VM/370: Terminal UserJ.s Guide. 

REDTYPE OFF suppresses red typing of error messages. 

IMPEX ON treats EXEC files as commands; an EXEC file is invoked 
when the filename of the EXEC file is entered. 



IMPEX OFF 



does not consider EXEC files as commands. You 
issue the EXEC command to execute an EXEC file. 



must 



IMPCE ON 



passes command names that CMS does not recognize to CP; 
that is, unknown commands are considered to be CP 
commands. 



IMPCP OFF generates an error message at the terminal if a command 
is not recognized by CMS. 

PROTECT ON protects the CMS nucleus against writing in its storage 
area. 



PROTECT OFF 



AUTOBEAD ON 



AUTOREAD OFF 



does not protect the storage area containing the CMS 
nucleus. 

specifies that a console read is to be issued 
immediately after command execution. ON is the default 
for non-display, non-buffered terminals. 

specifies that you do not want a console read to be 
issued until you press the Enter key or its equivalent. 
OFF is the default for display terminals because the 
display terminal does not lock, even when there is no 
READ active for it. 

Note: If you disconnect from one type of terminal and 
reconnect on another type, the AUTOREAD status remains 
unchanged. 



CMSDOS 
SYSNAME JCMSVSAM^ entryname 
CMSAMS 
CMSSEG 



allows you to replace a saved system name entry in the 
SYSNAMES table with the name of an alternative, or 
backup system. A separate SET SYSNAME command must be 
issued for each name entry to be changed. CMSDOS, 
CMSVSAM, CMSAMS, and CMSSEG are the default names 
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assigned to the systems when the CMS system is 
generated. 



CMSDOS 
NONSHARE J CMSVSAM 
CMSAMS 
CMSSEG 

specifies that you want your own nonshared copy of a 

normally shared named system. 

CMS/DOS Functions: 

The following functions describe the SET operands that apply to the 
CMS/DOS environment. 

DOS ON places your CMS virtual machine in the CMS/DOS 

environment. The logical unit SYSLOG is assigned to your 
terminal. 

mode specifies the mode letter at which the DOS/VS system 

residence is accessed; the logical assignment of SYSRES 
is made for the indicated mode letter. 

VSAM specifies that you are going to use the AMSERV command 

or you are going to execute programs to access VSAM data 
sets. 

DOS OFF returns your virtual machine to the normal CMS 
environment. All previously assigned system and 
programmer logical units are unassigned. 

UPSI nnnnnnnn sets the UPSI (User Program Switch Indicator) byte to 
the specified bit string of O's and 1's. If you enter 
fewer than 8 digits, the UPSI byte is filled in from the 
left and zero-padded to the right. 

UPSI OFF resets the UPSI byte to binary zeros. 

DOSPART nnnnnK specifies the size of the virtual partition you want to 
a program to execute in. The value, nnnnnK, may not 
exceed the amount of user free storage available in your 
virtual machine. You should use this function only when 
you can control the performance of a particular program 
by reducing the amount of available virtual storage. 

Note: In rare circumstances, it may happen that when a 
program is executed, the amount of storage available is 
less than the current DOSPART. Then, only the amount of 
storage available is obtained; no message is issued. 

DOSPART OFF specifies that you no longer want to control your 
virtual machine partition size. When the DOSPART 
setting is OFF, CMS computes the partition size whenever 
a program is executed. 

Responses 

None. To determine or verify the setting of a function, use the QUERY 
command. 
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Messages and Return Codes 

| DMSLIO002I FILE «fn' TXTLIB NOT FOUND EC=0 

DMSSET014E INVALID FUNCTION 'function' RC=24 
I DMSSET026E INVALID PARAMETER 'parameter' FOR 'function* FUNCTION RC=24 

DMSSET031E LOADER TABLES CANNOT BE MODIFIED RC=40 

DMSSET047E NO FUNCTION SPECIFIED RC=24 
| DMSSET048E INVALID MODE 'mode' RC=24 
| DMSSET050E PARAMETER MISSING AFTER (NONSHARE | SYSNAME | label) RC=24 

DMSSET061E NO TRANSLATION CHARACTER SPECIFIED RC=24 

DMSSET070E INVALID PARAMETER 'parameter' RC=24 
| DMSSET098W CMS OS SIMULATION NOT AVAILABLE RC=4 
| DMSSET099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 
| DMSSET100W SYSTEM NAME 'name' NOT AVAILABLE RC=4 
| DMSSET142S SAVED SYSTEM NAME 'name' INVALID RC=24 

| DMSSET333E nnnnnK PARTITION TOO LARGE FOR THIS VIRTUAL MACHINE RC=24 
| DMSSET400S SYSTEM 'sysname' DOES NOT EXIST RC=44 

| DMSSET401S V.M. SIZE (size) CANNOT EXCEED 'DMSDOS' START ADDRESS 
| (address) RC=104 

j DMSSET410S CONTROL PROGRAM ERROR INDICATION 'retcode' RC=nnn 
I where nnn is the actual error code from CP 
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SORT 

Use the SORT command to read fixed-length records from a CMS input file, 
arrange them in ascending EBCDIC order according to specified sort 
fields, and create a new file containing the sorted records. The format 
of the SORT command is: 



| SORT | fileid! fileid2 I 



where : 

fileidl is the file identifier (filename, filetype, filemode) of the 
file containing the records to be sorted. 

fileid2 is the file identifier (filename, filetype, filemode) of the 
new output file to contain the sorted records. 

Usage Notes 

1. The input and output files must not have the same file identifiers, 
since SORT cannot write the sorted output back into the space 
occupied by the input file. If a file with the same name as the 
output file already exists, the old file is erased. 

Entering Sort Control Fields: After the SORT command is entered, CMS 
responds with the following message on the terminal: 

DMSSRT604R ENTER SORT FIELDS: 

You should respond by entering one or more pairs of numbers of the form 
"xx yy" separated by one or more blanks. Each xx is the starting 
character position of a sort field within each input record and yy is 
the ending character position. The leftmost pair of numbers denotes the 
major sort field. The number of sort fields is limited to the number of 
fields you can enter on one line. The records can be sorted on up to a 
total of 253 positions. 

Virtual Storage Reguirements for Sorting: The sorting operation takes 
place with two passes of the input file. The first pass creates an 
ordered pointer table in virtual storage. The second pass uses the 
pointer table to read the input file in a random manner and write the 
output file. Therefore, the size of storage and the size and number of 
sort fields are the limiting factors in determining the number of 
records that can be sorted at any one time. An estimate of the maximum 
number of records that can be sorted is: 

VMSIZE - 132K 
NR _ — , 

14 ♦ NC 

where: NR is the estimated maximum number of input records; NC is the 
total number of characters in the defined sort fields; VMSIZE is the 
storage size of the virtual machine; and 132K is the size of the 
resident CMS nucleus. For example, enter the command and respond to the 
prompting message: 
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sort name address a1 sortedna address b1 

DMSSRT604R ENTER SORT FIELDS: 

1 10 25 28 

The records in the NAME ADDRESS file are sorted on positions 1-10 and 
25-28. The sorted output is written into the newly created file 
SORTEDNA ADDRESS. If you have a 320K virtual machine, you can sort a 
maximum of 6875 records. 

VMSIZE-132K 320K-132K 188K 192,512 

DI R = - _-_ - 6875 

14 + NC 14 + 14 28 28 

Responses 

DMSSRT604R ENTER SORT FIELDS: 

You are requested to enter SORT control fields. you should enter 
them in the form described in "Entering Sort Control Fields." 

Other Messages and Return Codes 

DMSSRT002E FILE • f m ft fm« NOT FOUND RC=28 

DMSSRT009E COLUMN 'col 1 EXCEEDS RECORD LENGTH RC=24 

DMSSRT019E IDENTICAL FILEIDS RC=24 

DMSSRT034E FILE ' f n ft fm« IS NOT FIXED LENGTH RC=32 

DMSSRT037E DISK 'mode 1 IS READ/ONLY RC=36 

DMSSRT053E INVALID SORT FIELD PAIR DEFINED RC=24 

DMSSRT054E INCOMPLETE FILEID SPECIFIED RC=24 

DMSSRT062E INVALID * IN FILEID RC=20 

DMSSRT063E NO LIST ENTERED RC=40 

DMSSRT070E INVALID PARAMETER 'parameter 1 RC=24 

DMSSRT104S ERROR «nn' READING FILE ' f n ft f m • FROM DISK RC=100 

DMSSRT105S ERROR 'nil' WRITING FILE ' f n ft fm' ON DISK RC=100 

DMSSRT212E MAXIMUM NUMBER OF RECORDS EXCEEDED RC=40 



176 IBM VM/370: CMS Command and Macro Reference 



SSEBV 



I SSERV 



Use the SSERV command in CMS/DOS to copy, display, print, or punch a 
book from a DOS/VS source statement library. The format of the SSERV 
command is: 




r n 

sublib bookname | ft | [ (options... [) ]] 
I COPY | 

[DISK] [PRINT] 
[PUNCH [TERM] 



where : 
sublib 



specifies the source statement sublibrary in which the book is 
cataloged. 



bookname specifies the name of the book in the DOS private or system 
source statement sublibrary. 



ft 



specifies the filetype of the file to be created on your 
A-disk. ft defaults to COPY if a filetype is not specified. 
The filename is always the same as the bookname. 



Options: You may enter as many options as you wish, depending on the 
functions you want to perform. 

DISK copies the book to a CMS file. 

PUNCH punches the book on the virtual punch. 

PRINT spools a copy of the book to your virtual printer. 

TERM displays the book on your terminal. 

H§3j9J§ Notes 

1. If you want to copy books from private libraries, you must issue an 
ASSGN command for the logical unit SYSSLB and identify the library 
on a DLBL command line using a ddname of IJSYSSL. 

If you want to copy books from the system library, you must have 
entered the CMS/DOS environment specifying the mode letter of the 
system residence volume. 

2. You should not use the SSERV command to copy books from E 
sublibraries, since they are in "edited" (that is, compressed) 
form. Use the ESERV command to copy and de-edit macros from an E 
sublibrary. 

Responses 

When you use the TERM option, the specified book is displayed at the 
terminal. 
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I Hi=§sacjes and Return Codes 

| DMSSRV003E INVALID OPTION 'option' RC=2U 

DMSSRVOOUE BOOK 'subl.book' NOT FOUND RC=28 

DMSSRV006E NO READ/WRITE 'A* DISK ACCESSED RC=36 

DMSSRY070E INVALID PARAMETER 'parameter' RC=2U 

DMSSRV097E NO 'SYSRES 1 VOLUME ACTIVE RC=36 

DMSSRV098E NO BOOK NAME SPECIFIED RC=24 

DMSSRV099E CMS/DOS ENVIRONMENT NOT ACTIVE RC=40 

DMSSRV105S ERROR « nn ' WRITING FILE ' f n ft fm« ON DISK RC=100 

DMSSRV113S DISK (CUU) NOT ATTACHED RC=100 

DMSSRV411S INPUT ERROR CODE 'nn' ON '{ SYSRES | SYSSLB } ' RC=100 

DMSSRV194S BOOK 'subl.book' CONTAINS BAD RECORDS RC=100 
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START 

I Use the START command to begin execution of CMS, OS or DOS programs that 
| were previously loaded or fetched. The format of the START command is: 

I I r i I 

I START | | entry [args...] | I 

I I I * I I 

I I «- J I 

where : 

entry passes control to the control section name or entry point 
name at execution time. The operand, entry, may be a 
filename only if the filename is identical to a control 
section name or an entry point name. 

* passes control to the default entry point. See the 

discussion of the LOAD command for a discussion of the 
default entry point selection. 

args... are arguments to be passed to the started program. If user 
arguments are specified, entry or * must be specified; 
otherwise, the first argument is taken as the entry point. 
Arguments are passed to the program via general register 1. 
The entry operand and any arguments become a string of 
doublewords, one argument per doubleword, and the address of 
the list is placed in general register 1. 

Usage Notes: 

1 . Any undefined names or references specified in the files loaded 
into storage are defined as zero. Thus, if there is a call or 
branch to a subroutine from a main program, and if the subroutine 
has never been loaded, the call or branch transfers control to 
location zero of the virtual machine at execution time. 

2. Do not use the START command for programs that are generated via 
the GENMOD command with the NOMAP option. The START command does 
not execute properly for such programs. 

Responses 

DMSLI0740I EXECUTION BEGINS... 

is displayed when the designated entry point is validated. 

| This message is suppressed if CMS/DOS is active and the COMP option 
| is specified in the FETCH command. 

I!EE2£ MQ§§ai3e§ and Return Codes 

DMSLI0021E ENTRY POINT 'name' NOT FOUND RC=40 
DMSLI0055E NO ENTRY POINT DEFINED RC=U0 
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I STATE /STATEW 

I Use the STATE command to verify the existence of a CMS, OS, or DOS file 

| on any accessed disk; use the STATEW command to verify the existence of 

j a CMS,, OS, or DOS file on any accessed read/write disk. The formats of 

| the STATE and STATEW commands are: 

| | /STATE \ \ fn ft [fi] 
| | (STATEW/ | * * * 

i , __ 

where :: 

fn is the filename of the file whose existence is to be verified. If 
fn is specified as *, the first file found satisfying the rest of 
the fileid is used. 

ft is the filetype of the file whose existence is to be verified. If 
ft is specified as *, the first file found satisfying the rest of 
the fileid is used. 

fm is the filemode of the file whose existence is to be verified. If 
fm is omitted, or specified as *, all your disks are searched. 

Osa^e JS2i§s: 

1. If you issue the STATEW command specifying a file that exists on a 
read-only disk, you receive error message DMSSTT002E. 

2. When you code an asterisk in the fn or ft fields, the search for 
the file is ended as soon as any file satisfies any of the other 
conditions. For example, the command 

state * file 

executes successfully if any file on any accessed disk (including 
the system disk) has a filetype of FILE. 

3. To verify the existence of an OS or DOS file, when DOS is set OFF, 
you must issue the FILEDEF command to establish a CMS file 
identifier for the file. For example, to verify the existence of 
the OS file TEST. DATA on an OS C-disk you could enter 

filedef check disk check list c dsn test data 
state check file 

where CHECK LIST is the default filename and filetype (FILE ddname) 
associated with the OS data set name. 

4. To verify the existence of an OS or DOS file when the CMS/DOS 
environment is active, you must issue the DLBL command to establish 
a CMS file identifier for the file. For example, to verify the 
existence of the DOS file TEST. DATA on a DOS C-disk, you could 
enter 

dlbl check c dsn test data 
state file check 

where FILE CHECK is the default CMS filename and filetype (FILE 
ddname) associated with the DOS file-id. 
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Responses 

| The CMS Ready message indicates that the specified file exists. 

DMSSTT227I PROCESSING VOLUME "no 1 IN DATA SET ■ data set name' 

The specified data set has multiple volumes; the volume being 
processed is shown in the message. The STATE command treats 
end-of-volume as end-of-file and there is no end-of-volume 
switching. 

DMSSTT228I USER LABELS BYPASSED ON DATA SET • data set name' 

The specified data set has disk user labels; these labels are 
skipped. 

Error Messages and Return Codes 

DMSSTT002E FILE • f n ft fm' NOT FOUND RC=28 

DMSSTT048E INVALID MODE 'mode' RC=24 

DMSSTT054E INCOMPLETE FILEID SPECIFIED RC=2U 

DMSSTT062E INVALID 'char 1 IN FILEID 'fn ft* RC=20 

DMSSTT069E DISK 'mode 1 NOT ACCESSED RC=36 

DMSSTT070E INVALID PARAMETER "parameter' RC=24 

DMSSTT229E UNSUPPORTED OS DATA SET, ERROR 'code* RC=code 

Note; You can invoke the STATE command from the terminal, from an EXEC 
file, or as a function from a program. If STATE is invoked as a 
function or from an EXEC file that has the SCONTROL NOMSG option in 
effect, the message DMSSTT002E FILE fn ft fm NOT FOUND is not issued. 
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SVCTRACE 

Use the SVCTRACE command to trace and record information about 
supervisor calls occurring in your virtual machine. The format of the 
SVCTRACE command is: 



I SVCTrace 



\OFFJ 



where :; 

ON starts tracing all SVC instructions issued within CMS. 

OFF stops SVC tracing. 

U§§Sir Notes 

1. The trace information recorded on the printer includes: 

<» The virtual storage location of the calling SVC instruction and 
the name of the called program or routine. 

• The normal and error return addresses. 

« The contents of the general registers both before the SVC-called 
program' is given control and after a return from that program. 

• The contents of the general registers when the SVC handling 
routine is finished processing. 

• The contents of the floating-point registers before the 
SVC-called program is given control and after a return from that 
program. 

• The contents of the floating-point registers when the SVC 
handling routine is finished processing. 

• The parameter list passed to the SVC. 

2. To terminate tracing previously established by the SVCTRACE 
command, issue the HO or SVCTRACE OFF commands. SVCTRACE OFF and 
HO cause all trace information recorded, up to the point they are 
issued, to be printed on the virtual spooled printer. On 
typewriter terminals SVCTRACE OFF can be issued only when the 
keyboard is unlocked to accept input to the CMS command 
environment. To terminate tracing at any other point in system 
processing, HO must be issued. To suspend tracing temporarily 
during a session, interrupt processing and enter the Immediate 
command SO (Suspend Tracing) , To resume tracing that was suspended 
with the SO command, enter the Immediate command RO (Resume 
Tracing) . 

If you issue the CMS Immediate command HX or you log off the 
VM/370 system before termination of tracing previously set by the 
SVCTRACE command, the switches are cleared automatically and all 
recorded trace information is printed on the virtual spooled 
printer. 
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Responses 

A variety of information is printed whenever the 

SVCTRACE ON 

command is issued. 

The first line of trace output starts with a -, or + , or *. The 
format of the first line of trace output is: 



CI 



N/D = xxx/dd name FROM loc OLDPSW = pswl GOPSW = psw2 [ RC=rc ] 

where : 

indicates information recorded before processing the SVC. 

+ indicates information recorded after processing the SVC, unless 
* applies. 

* indicates information recorded after processing a CMS SVC which 
had an error return. 

N/D is an abbreviation for SVC number and depth (or level) . 

xxx is the number of the SVC call (they are numbered sequentially) . 

dd is the nesting level of the SVC call. 

name is the macro or routine being called. 

loc is the program location from which the SVC was issued. 

pswl is the PSW at the time the SVC was called. 

psw2 is the PSW with which the routine being called is invoked, if 
the first character of this line is a minus sign (-) . If the 
first character of this line is a plus sign or asterisk (+ or 
*) , PSW2 represents the PSW which returns control to the user. 

re is the return code from the SVC handling routine in general 
register 15. This field is omitted if the first character of 
this line is a minus sign (-) , or if this is an OS SVC call. 
For a CMS SVC, this field is if the line begins with a plus 
sign (+) , and nonzero for an asterisk (*) . Also, this field 
equals the contents of register 15 in the "GPRS AFTER" line. 

The next two lines of output are the contents of the general 
registers when control is passed to the SVC handling routine. This 
output is identified at the left by ".GPRSB". The format of the output 
is: 

.GPRSB =hhhhhhhh *dddddddd* 
=hhhhhhhh *dddddddd* 

where h represents the contents of a general register in hexadecimal 
format and d represents the EBCDIC translation of the contents of a 
general register. The contents of general registers through 7 are 
printed on the first line, with the contents of registers 8 through F on 
the second line. The hexadecimal contents of the registers are printed 
first, followed by the EBCDIC translation. The EBCDIC translation is 
preceded and followed by an asterisk (*) . 
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The next line of output is the contents of general registers r 1, 
and 15 when control is returned to your program. The output is 
identified at the left by ".GPRS AFTER :". The format of the output is: 

.GPRS AFTER : R0-R1 = h h *dd* R15 = h *d* 

where h represents the hexadecimal contents of a general register and d 
is the EBCDIC translation of the contents of a general register. The 
only general registers that CMS routines alter are registers 0, 1 , and 
15 so only those registers are printed when control returns to your 
program. The EBCDIC translation is preceded and followed by an asterisk 
(*) • 

The next two lines of output are the contents of the general 
registers when the SVC handling routine is finished processing. This 
output is identified at the left by ".GPRSS." The format of the output 
is: 

.GPRSS =hhhhhhhh *dddddddd* 
=hhhhhhhh *dddddddd* 

where h represents the hexadecimal contents of a general register and d 
represents the EBCDIC translation of the contents of a general 
register. General registers through 7 are printed on the first line 
with registers 8 through F on the second line. The EBCDIC translation 
is preceded and followed by an asterisk (*) . 

The next line of output is the contents of the calling routined 
floating-point registers. The output is identified at the left by 
" .FPRS". The format of the output is: 

.fprs = f f f f *gggg* 

where f represents the hexadecimal contents of a floating-point register 
and g is the EBCDIC translation of a floating-point register. Each 
floating point register is a doubleword; each f and g represents a 
doubleword of data. The EBCDIC translation is preceded and followed by 
an asterisk (*) . 

The next line of output is the contents of floating-point registers 
when the SVC handling routine is finished processing. The output is 
identified by ".FPRSS" at the left. The format of the output is: 

.FPRSS = f f f f *gggg* 

where f represents the hexadecimal contents of a floating-point register 
and g is the EBCDIC translation. Each floating-point register is a 
doubleword and each f and g represents a doubleword of data. The EBCDIC 
translation is preceded and followed by an asterisk (*) . 

The last two lines of output are only printed if the address in 
register 1 is a valid address for the virtual machine. If printed, the 
output is the parameter list passed to the SVC. The output is 
identified by ".PARM" at the left. The output format is: 

.PARM =hhhhhhhh *dddddddd* 
=hhhhhhhh *dddddddd* 

where h represents a word of hexadecimal data and d is the EBCDIC 
translation. The parameter list is found at the address contained in 
register 1 before control is passed to the SVC handling program. The 
EBCDIC translation is preceded and followed by an asterisk (*) . 
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Figure 17 summarizes the types of SVC trace output. 



Identification | 




Comments 
The SVC and the routine which issued the SVC. 



.GPRSB 



.GPRS AFTER 



.GPRSS 



.FPRS 



.FPRSS 



.PARM 



Contents of general registers when control is passed 
to the SVC handling routine. 

i Contents of general registers 0, 1, and 15 when 
control is returned to your program. 

Contents of the general registers when the SVC 
handling routine is finished processing. 

(Contents of floating-point registers before the 
SVC— called program is given control and after 
returning from that program. 

IContents of the floating-point registers when the 
SVC handling routine is finished processing. 

The parameter list, when one is passed to the SVC. 



Figure 17. Summary of SVC Trace Output Lines 



Messages and Return Codes 

DMSOVR014E INVALID FUNCTION •function 1 RC=24 

DMSOVR047E NO FUNCTION SPECIFIED RC=24 

DMSOVR104S ERROR • nn ' READING FILE »DMSOVR MODULE 1 ON DISK RC=100 

DMSOVR109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 
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SYNONYM 

Use the SYNONYM command to invoke a table of synonyms to be used with, 
or in place of, CMS and user-written command names. You create the 
table yourself using the CMS Editor. The form for specifying the 
entries for the table is described under "The User Synonym Table." 

The names you define can be used either instead of or in conjunction 
with the standard CMS command truncations. However, no matter what 
truncations, synonyms, or truncations of the synonyms are in effect, the 
full real name of the command is always accepted. The format of the 
SYNONYM command is: 



r r r m 
SYNonym | |fn I SYNONYM |fm||| [ (options. ..[)] ] 
I I IAJIII 

L L | * | J J 

L J 

r i 

options: |STD | [CLEAR] 

|NOSTD| 

L J 



where : 

fn is the filename of the file containing your synonyms table. 

fm is the filemode of the file containing your synonyms; if omitted, 
your A-disk and its extensions are searched. If you specify fm, 
you must enter the keyword, SYNONYM. If you specify fm as an 
asterisk (*) , all disks are searched for the specified SYNONYM 
file. 

Op t ions : 

STD specifies that standard CMS abbreviations are accepted. 

NOSTD standard CMS abbreviations are not to be accepted. (The 
full CMS command and the synonyms you defined can still 
be used.) 

CLEAR removes any synonym table set by a previously entered 
SYNONYM command. 

I 1. If you enter the SYNONYM command with no operands, the system 
| synonym table and the user synonym table (if one exists) are 
| listed. 

2. The SET ABBREV ON or OFF command, in conjunction with the SYNONYM 
command, determines which standard and user-defined forms of a 
particular CMS command are acceptable. 
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THE USER SYNONYM TABLE 

You create the synonym table using the CMS Editor. The table must be a 
file with the filetype SYNONYM. The file consists of 80-byte 
fixed-length records in free form format with columns 73-80 ignored. 
The format for each record is: 

systemcommand usersynonym count 

where : 

systemcommand is the name of the CMS command, or MODULE or EXEC file for 
which you are creating a synonym. 

usersynonym is the synonym you are assigning to the command name. 
When you create the synonym, you must follow the same 
syntax rules as for commands, that is, you must use the 
character set used to create commands, the synonym may be 
no longer than 8 characters, and so on. 

count is the minimum number of characters that must be entered 

for the synonym to be accepted by CMS. If omitted, the 

entire synonym must be entered (see the following 
example) . 

A table of command synonyms is built from the contents of this file. 
You may have several synonym files but only one may be active at a time. 
For example, if the synonym file named MYSYN contains: 

MOVEFILE MVIT 

then, after you have issued the command 

synonym mysyn 

the synonym MVIT can be entered as a command name to execute the 
MOVEFILE command. It cannot be truncated since no count is specified. 
If MYSYN SYNONYM contains 

ACCESS GETDISK 3 

then, the synonyms GET, GETD, GETDI, GETDIS, or GETDISK can be entered 
as the command name instead of ACCESS. 

If you have an EXEC file named TDISK, you might have a synonym entry 

TDISK TDISK 2 

so that you can invoke the EXEC procedure by specifying the truncation 
TD. 

The Relationship Between the SET ABBREV and SYNONYM Commands 

The default values of the SET and SYNONYM commands are such that the 
system synonym abbreviation table is available unless otherwise 
specified. 

The system synonym abbreviation table for the FILEDEF command states 
that FI is the minimum truncation. Therefore, the acceptable 
abbreviations for FILEDEF are: FI, FIL, FILE, FILED, FILEDE, and 
FILEDEF. The system synomym abbreviation table is available whenever 
both SET ABBREV ON and SYNONYM (STD) are in effect. 

Section 2. CMS Commands 187 



SYNONYM 



If you have a synonym table with the file identification USERTAB 
SYNONYM A, that has the entry 

FILEDEF USENAME 3 

then, USENAME is a synonym for FILEDEF, and acceptable truncations of 
USENAME are: USE, USEN, USENA, USENAM, and USENAME. The user synonym 
abbreviation table is available whenever both SET ABBREV ON and SYNONYM 
USERTAB are specified. 

No matter what synonyms and truncations are defined, the full real 
name of the command is always in effect. 

Figure 18 lists the forms of the system command and user synonyms 
available for the various combinations of the SET ABBREV and SYNONYM 
commands. 

Responses 

When you enter the SYNONYM command with no operands, the synonym table 
or tables currently in effect are displayed. 

SYSTEM USER SHORTEST 
COMMAND SYNONYM FORM (IF ANY) 



This response is the same as the response to the command QUERY 
SYNONYM ALL. 

DMSSYN711I NO SYSTEM SYNONYMS IN EFFECT 

This response is displayed when you issue the SYNONYM command with 
no operands after the command SYNONYM (NOSTD) has been issued. 

DMSSYN712I NO SYNONYMS (DMSINA NOT IN NUCLEUS) 

The system routine which handles SYNONYM command processing is not 
in the system. 

.Q£!L§r Messages and Return Codes 

DMSSYN002E FILE • f n ft fm» NOT FOUND RC=28 

DMSSYN003E INVALID OPTION •option 1 RC=2U 

DMSSYN007E FILE « f n ft fm' NOT FIXED, 80 CHAR RECORDS RC=32 

DMSSYN032E INVALID FILETYPE • f t • RC=24 

DMSSYN056E FILE «fn ft fm' CONTAINS INVALID RECORD FORMATS RC-32 

DMSSYN066E 'option AND 'option 1 ARE CONFLICTING OPTIONS RC=24 

DMSSYN104S ERROR • nn • READING FILE • f n ft fm» FROM DISK RC=100 
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| Acceptable | 
| Command | 
Options | Forms | Comments 


SET ABBREV ON | FI | The ABBREV ON option of the SET 
SYN USERTAB (STD | FIL j command and the STD option of the 

| . | SYNONYM command make the system 
| . | table available. The user synonym, 
| . | USENAME is available 
| FILEDEF | because the synonym table 
| USE | (USERTAB) is specified on the 
I USEN | SYNONYM command. The truncations 
| . | for USENAME are available because 
| . j SET ABBREV ON was specified with 
| . | the USERTAB also available. 
| USENAME | 

SET ABBREV OFF | FILEDEF |The user-defined synonym, USENAME, 
SYN USERTAB (STD | USENAME | is permitted because the user 

| | synonym table (USERTAB) is speci- 
| | fied on the SYNONYM command. No 
| | system or user truncations are 
| | permitted. 


SET ABBREV ON | FILEDEF |The system synonym table is un- 
SYN USERTAB (NOSTD | USE | available because the NOSTD option 

| USEN | is specified on the SYNONYM com- 
| . | mand. The user synonym, USENAME, 
| . 1 is available because the user syno- 
| . | nym table (USERTAB) is specified on 
| USENAME | the SYNONYM command and the trun- 
| | cations of USENAME are permitted 
| | because SET ABBREV ON is specified 
| | with USERTAB also available. 

SET ABBREV OFF | FILEDEF |The system synonym table is made 
SYN USERTAB (NOSTD| USENAME | unavailable either by the SET 

| | ABBREV OFF command or by the SYN 
| | (NOSTD command. The synonym, 
1 | USENAME, is permitted because the 
| | user— defined synonym table 
| | (USERTAB) is specified on the 
| | SYNONYM command. The truncations 
| | for USENAME are not permitted 
| | because the SET ABBREV OFF option 
| | is in effect. 

SET ABBREV ON | FI |The user-defined table is now un- 
SYN (CLEAR STD | FIL | available. The system synonym 

| . | table is available because both 
| . | the ABBREV ON option of the SET 
| . | command and the STD option of the 
| FILEDEF | SYNONYM command are specified. 

SET ABBREV OFF | FILEDEF | Because CLEAR is specified on the 
SYN (CLEAR STD j | SYNONYM command, the synonym and 

j | its truncations are no longer 

SET ABBREV ON | | available. Either the SET ABBREV 
SYN (CLEAR NOSTD | | OFF command or the SYNONYM (NOSTD 

| | command make the system synonym 

SET ABBREV OFF | | table unavailable. 
SYN (CLEAR NOSTD | | 



Figure 18. System and User-Defined Truncations 
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Use the TAPE command to dump CMS-f ormatted files from disk to tape, load 
previously dumped files from tape to disk, and perform various control 
operations on a specified tape drive. TAPE is used solely for CMS 
files; therefore, the files on tape are in a unique CMS format. The 
TAPE command does not process multivolume files. Disk files to be 
dumped can contain either fixed- or variable-length records. The format 
of the TAPE command is: 



TAPE 



DUMP jfn} fft\ |fm| 



\* ) I* I [ (optionA optionB optionD[) ]] 

L J 

{*"} {"} It' 



r r t t 

LOAD l/fn\ /ft) |fm| | [(optionB optionC optionD[)]] 

I I 

L L J J 



SCAN | 



{* fn } {."} 



SKIP | (fn) (ft) | 

L J 



| [ (optionB optionC optionD[) ]] 



[ (optionB optionC optionD[) ]] 



MODESET 



[ (optionD[) ]] 



\ tapcmd 


|n| [ (optionD[) ]] 
111 

L J 


opt ion A : 


r t 

|WTM | 
INOWTMJ 

L J 


optionB : 


r t 

| NOPRint | 
IPRint | 
| Term | 
IDISK | 

L J 


op t i o nC : 


r i 

|EOT | 
|EOF n| 
IEOF 11 

L J 



2Eii2Ii5 • I I TAPi | 
I 1 1 A PI | 

| L J 

lr t 
||cuu | 
M18I I 

LL J J 



|7TRACK| [DEN den] [ TRTCH a] 
|9TRACK| 

L J 
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where : 

DUMP JfnHftUfm] 

I* A* JC* ] - 

dumps one or more disk files to tape. If fn and/or ft is 
specified as an asterisk (*) all files that satisfy the 
other file identifier are dumped. 

If fm is coded as a letter, that disk and its extensions are 
searched for the specified file (s) . If f m is coded as a 
letter and number, only files with that mode number and 
letter are dumped. If fm is coded as *, all accessed disks 
are searched for the specified f ile (s) . If fm is not 
specified, only the A-disk and its extensions are searched. 

LOAD [JfnWft)[fi]] 

[\* A* /[A ]] 

reads tape files onto disk. If a file identifier is 
specified, only that one file is loaded. If the option EOF 
n is specified and no file identifier is entered, n tape 
files are written to disk. If an asterisk (*) is specified 
for fn or ft, all files within EOF n that satisfy the other 
file identifier are loaded. 

The files are written to the disk indicated by the filemode 
letter. The filemode number, if entered, indicates that 
only files with that filemode number are to be loaded. 



SCAN [jfn)(ftn 

ci* n* n 

positions the tape at a specified point, and lists the 
identifiers of the files it scans. Scanning occurs over n 
tape marks, as specified by the option EOF n (the default is 
1 tape file) . However, if a file identifer (fn and ft) is 
specified, scanning stops upon encountering that file; the 
tape remains positioned in front of the file. 

SKIP [ /fnWft)] 

n* iu h 

positions the tape at a specified point and lists the 
identifiers of the files it skips. Skipping occurs over n 
tape marks, as specified by the option EOF n (the default is 
1 tape mark) . However, if a file identifier (fn and ft) is 
specified, skipping stops after encountering that file; the 
tape remains positions after the file. 

MODESET sets the values specified by the DEN, TRACK, and TRTCH 
options. These values remain in effect for the specified 
tape until they are changed in a subseguent TAPE command. 

r i 

tapcmd |n| specifies a tape control function (tapcmd) to be executed n 
HI times (default is 1 if n is not specified) : 



L J 



Tapcmd Action 

BSF Backspace n tape marks 

BSR Backspace n tape records 

ERG Erase gap 

FSF Forward space n tape marks 

FSR Forward space n tape records 

REW Rewind tape to load point 

RUN Rewind tape and unload 

WTM Write n tape marks 
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Options: If conflicting options are specified, the last one entered 
is in effect. 

HTM writes a tape mark on the tape after each file is 
dumped. 

NOW.TM writes a tape mark after each file is dumped, then 
backspaces over the tape mark so that subsequent files 
written on the tape are not separated by tape marks. 

NOPRINT does not spool the list of files dumped, loaded, scanned, 
or skipped to the printer. 

PRINT spools the list of files dumped, loaded, scanned, or 
skipped to the printer. 

TERM displays a list of files dumped, loaded, scanned, or 
skipped at the terminal. 

DISK creates a disk file containing the list of files dumped, 
loaded, scanned, or skipped. The disk file has the file 
identification of TAPE MAP A5. 



EOT 



reads the tape until an end-of-tape indication is 
received. 



EOF n 
EOF 1 



reads the tape through a maximum of n tape marks. The 
default is EOF 1. 



TAPn 
18n 



7TRACK 

9TRACK 
DEN den 



specifies the symbolic tape identification (TAPn) or the 
actual device address of the tape to be read from or 
written to where n is 1, 2, 3, or 4. The default is TAP1 
or 181. The unit specified by cuu must previously have 
been attached to your CMS virtual machine before any tape 
I/O operation can be attempted. Only symbol names TAP1 
through TAPU and virtual device addresses 181 through 184 
are supported. 

specifies a 7-track tape. Odd parity, data convert on, 
and translate off are assumed unless TRTCH is specified. 

specifies a 9-track tape. 

is the tape density where den is 200, 556, 800, 1600, or 
6250. If 200 or 556 is specified, 7TRACK is assumed. If 
1600 or 6250 is specified, 9TRACK is assumed; if 800 is 
specified, 9TRACK is assumed unless 7TRACK is specified. 
In the case of either 800/1600 or 1600/6250 dual-density 
drives, 1600 is the default. 



TRTCH a is the tape recording technique for 7-track tape. If 
TRTCH is specified, 7TRACK is assumed. One of the 
following must be specified as a: 

a Meaning 

odd parity, data convert off, translate off 

OC odd parity, data convert on, translate off 

OT odd parity, data convert off, translate on 

E even parity, data convert off, translate off 

ET even parity, data convert off, translate on 
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Usa^e Notes 

1. Tape records written by the CMS TAPE DUMP command are 805 bytes 
long. The first character is a binary 2 (X , 02 , ) r followed by the 
characters CMS and an EBCDIC blank (X^UO 1 )* followed by 800 bytes 
of file data packed without regard for logical record length. In 
the final record, the character N replaces the blank after CMS, and 
the data area contains CMS file directory information. 

2. If a tape file contains a large number of CMS files, that would not 
fit on disk, the tape load operation may terminate if there is not 
enough disk space to hold the files. To prevent this, when you 
dump the files, separate logical files by tape marks, then forward 
space to the appropriate file. 



Because the CMS file directory is the last 
TAPE command creates a separate workfile s 
rereading can be avoided when the disk file 
criteria is not satisfied the workfile 
satisfied the workfile is renamed. This 
CMSUT1, which may exist if a previous TAPE 
terminated. If the work file is accidenta 
subseguently loaded, it appears on your disk 



record of the file, the 
o that backspacing and 

is built. If the load 
is erased; if it is 
workfile is named TAPE 

command has abnormally 
lly dumped to tape and 

as TAPE CMSUT2. 



The RUN option (rewind and unload) indicates completion before the 
physical operation is completed. Thus, a subseguent operation to 
the same physical device may encounter a device busy situation. 



For more 
Guide. 



information on tape file handling, see the CMS UserJ.s 



Responses 

DMSTPE701I NULL FILE 

A final record was encountered and no prior records were read in a 
TAPE LOAD operation. No file is created on disk. 

If the TERM option is in effect, the following is displayed at the 
terminal depending on the operation specified: 



LOADING.... 
fn ft fm 



SKIPPING, 
fn ft fm 



DUMPING... 
fn ft f 



SCANNING., 
fn ft f 
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When a tape mark is encountered the following 
terminal if the TERM option is specified: 

END-OF-FILE OR END-OF-TAPE 



is displayed at the 



Other Messages and Return Codes 



DMSTPE002E 
DMSTPE003E 
DMSTPE010E 
DMSTPE01UE 
DMSTPE017E 
DMSTPE023E 
DMSTPE027E 
DMSTPE029E 

DMSTPE037E 
DMSTPE042E 
DMSTPE043E 
DMSTPE047E 
DMSTPE048E 
DMSTPE057E 
DMSTPE058E 
DMSTPE070E 
DMSTPE104S 
DMSTPE105S 
DMSTPE110S 
DMSTPE111S 
DMSTPE113S 
DMSTPE115S 



RC=36 



RC=36 



FILE »fn ft fm» NOT FOUND RC=28 

INVALID OPTION •option 1 RC=24 

PREMATURE EOF ON FILE ' f n ft fm« RC=40 

INVALID FUNCTION 'function 1 RC=24 

INVALID DEVICE ADDRESS • cuu • RC=24 

NO FILETYPE SPECIFIED RC=24 

INVALID DEVICE 'device name' RC=24 

INVALID PARAMETER 'parameter' IN THE OPTION 'option' FIELD 

RC=24 

DISK 'mode' IS READ/ONLY 

NO FILEID SPECIFIED RC=24 

•TAPn(cuu)' IS FILE PROTECTED 

NO FUNCTION SPECIFIED RC=24 

INVALID MODE 'mode' RC=2U 

INVALID RECORD FORMAT RC=32 

END-OF-FILE OR END-OF-TAPE RC=40 

INVALID PARAMETER 'parameter' RC=24 

ERROR 'nn« READING FILE • f n ft fm« FROM 

ERROR 'nn' WRITING FILE «fn ft fm» 

ERROR READING 'TAPn (cuu) ' RC=100 

ERROR WRITING 'TAPn(cuu)' RC=100 

TAPn (CUU) NOT ATTACHED RC=100 

{CONVERSION|{7|9 }-TRACK | { 800 | 6250 } 

DENSITY} FEATURE NOT SUPPORTED ON 



ON 



DISK RC=100 
DISK RC=10 



BPI (TRANSLATION | DUAL 
DEVICE 'cuu' RC=88 
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I TAPEMAC 



Use the TAPEMAC command to create a CMS MACLIB from an unloaded 
partitioned data set (PDS) from a tape created by the IEHMOVE utility 
program under OS. The PDS from which the tape was created can be 
blocked, but the logical record length must be 80. The format of the 
TAPEMAC command is: 



TAPEMAC | fn [ (options. ..[)] ] options: 



r t r -i 

|TAPn| |ITEMCT yyyyyl 
II API I HTEMCT_50000 | 

t J L ~ ~" J 



where : 

fn specifies the filename of the first, or only, CMS MACLIB to be 
created on the A-disk. If fn MACLIB already exists on the A-disk, 
the old one is erased; no warning message is issued. 

0£t ion s : 

TAPn specifies the symbolic address of the tape, where n is a number 
between 1 and 4 corresponding to virtual device addresses 181 
through 184, respectively. The default is TAP1. 

itemct yyyyy 

specifies the item count threshold of each MACLIB to be 
created, which is the maximum number of records to be written 
into each file. yyyyy is a number between and 62500 (commas 
are not allowed) . If ITEMCT is not specified, the default is 
50000. 

H:§a<je Notes 

1. Tape records are read and placed into fn MACLIB until the file size 
exceeds the ITEMCT (item count) ; loading then continues until the 
end of the current member is reached. Then another CMS file is 
created; its filename consists of the number 2 appended to the end 
of the filename specified (fn) if the filename is 7 characters or 
less. The appended number overlays the last character of the 
filename if the name is 8 characters long. Loading then continues 
with this new name. For example, if you enter the command 

tapemac mylib 

you may create files named MYLIB MACLIB, MYLIB2 MACLIB, MYLIB3 
MACLIB... 

This process continues until up to nine CMS files have been 
created. If more data exists on the tape than can fit in 9 CMS 
files, processing is terminated with the error message DMSTMA139S. 
The maximum size of the unloaded PDS which can be loaded into CMS 
MACLIBs would be approximately 9 times 62500 or 584,500 records. 
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I fi^sgonses 

I The TAPENAC command displays the message: 

| LOADING fn MACLIB 

| for each macro library created. 

I O^her Messages and Return Codes 

| DMSTMA001E NO FILENAME SPECIFIED RC=24 

| DHSTMA003E INVALID OPTION 'option" RC=24 

| DMSTMA057E INVALID RECORD FORMAT RC=32 

| DMSTMA070E INVALID PARAMETER "parameter* RC=24 

| DMSTMA105S ERROR nn WRITING FILE fn ft ON DISK RC=100 

| DMSTMA109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=104 

| DMSTMA110S ERROR READING TAPn RC=100 

| DMSTMA137S ERROR nn ON STATE FOR fn ft RC=100 

| DMSTMA138S ERROR nn ERASING "fn ft" BEFORE LOADING TAPE RC=100 

I DMSTMA139S TAPE FILE EXCEEDS 9 CMS MACLIBS RC=104 
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Use the TAPPDS command to create CMS disk files from tapes created by 
the following OS utility programs: 

• IEBPTPCH (files may be sequential or partitioned, but must be in 
unblocked card-image format) . 

• IEBUPDTE (files may be blocked or unblocked) . 

• IEHMOVE (unloaded partitioned data sets are read) . 

The tape can be unlabeled or it can contain OS standard labels. The 
format of the TAPPDS command is: 



TAPPDS 



|fn | ft | £m | | | [ (options... [) ]] 

I * I * I All II 

I I I* I II 

L L L JJJ 



opt ion s : 


r t 

|PDS | 
INOPDS | 
| UPDATE | 

L J 


r t 

|C0L1 | 
I N0C0L1 | 

L J 


r i 

|TAPn| 
ITAPJI 

L J 




r i 
|END | 
1 N OE ND | 

L "~ J 


r t 

IMAXTEN | 
|N0MAXTEN| 

L J 





w her e : 

fn is the filename of the disk file to be created from the sequential 
tape file. If the tape contains members of a partitioned data set 
(PDS) , fn must be specified as an asterisk; one file is created for 
each member with a filename the same as the member name. If NOPDS 
or UPDATE is specified, and you do not specify fn, or specify it as 
*, the default filename is TAPPDS. 

ft is the filetype of the newly created files. The default filetypes 
are CMSUT1 (for PDS or NOPDS) and ASSEMBLE (for UPDATE) . The 
defaults are used if ft is omitted or specified as *. 

fm is the mode of the disk to contain the new files. If this field is 
omitted or specified as an asterisk (*) , A1 is assumed. 



Options: If conflicting options are specified, the last one entered 
is used. All options, except TAPn, are ignored when unloaded PDS 
tapes are read. 



PDS 



indicates that the tape contains members of an OS 
partitioned data set, each preceded by a MEMBER NAME=name 
statement. The tape must have been created by the OS 
IEBPTPCH service program if this option is specified. 



NOPDS 



indicates that the tape contains one file. 
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UPDATE indicates that the tape file is in IEBUPDTE control file 

format. The filename of each file is taken from the 

NAME= parameter in the "./ ADD" record that precedes each 
member. (See Usage Note 2.) 

COL 1 reads data from columns 1-80. You should specify this 
option when you use the UPDATE option. 

J?0COL.l reads data from columns 2-81; column 1 contains control 
character information. This is the format produced by 
the OS IEBPTPCH service program. 

TAPn is the tape unit number. n can be 1, 2, 3, or 4, 
representing virtual units 181, 182, 183 r and 184, 
respectively. If not specified, TAP1 is assumed. 

END considers an END statement a delimiter for the current 
member.. 

IJOEND specifies that END statements are not to be treated as 
member delimiters, but are to be processed as text. 

MAXTEN reads up to ten members. This is valid only if the PDS 
option is selected. 

NOMAXTEN reads any number of members. 



Usage Notes 

1. You can use the TAPE command to position a tape at a particular 
tape file before reading it with the TAPPDS command. 

2. If you use the UPDATE option, you must also specify the COL1 
option. Each tape record is scanned for a "./ ADD" record 
beginning in column 1. When a "./ ADD" record is found, subsequent 
records are read onto disk until the next "./ ADD" record is 
encountered or until a "./ ENDUP" record is encountered. 

A "./ ENDUP" record or a tape mark ends the TAPPDS command 
execution; the tape is not repositioned. 

"./ label" records are not recognized by CMS and are included in 
the file as data records. 

If the NAME= parameter is missing on the "./ ADD" record or if it 
is followed by a blank, TAPPDS uses the default filename, TAPPDS, 
for the CMS disk file. If this happens more than once during the 
execution of the command, only the last unnamed member is contained 
in the TAPPDS file. 

3. If you are reading a macro library from a tape created the IEHMOVE 
utility, you can create a CMS MACLIB file directly by using the 
TAPEMAC command. 

Responses 

DMSTPD703I FILE ' f n ft [fm]" COPIED 

The named file is copied to disk. 
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DMSTPD707I TEN FILES COPIED 

The MAXTEN option was specified and ten members have been copied. 

If the tape being read contains standard OS labels, the labels are 
displayed at the terminal. 

0£llisl Hf-ssacjes and Return Codes 

DMSTPD003E INVALID OPTION 'option* RC=2U 

DMSTPD058E END-OF-FILE OR END-OF-TAPE RC=40 

DMSTPD105S ERROR • nn • WRITING FILE «fn ft fm» ON DISK RC=100 

DMSTPD109S VIRTUAL STORAGE CAPACITY EXCEEDED RC=10U 

DMSTPD110S ERROR • nn ' READING 'TAPnfcuu)' RC=100 
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Use the TXTLIB command to update CMS text libraries. The format of the 
TXTLIB command is: 



TXTlib 



GEN libname fn1 [fn2 ...] 

ADD libname fn1 [fn2 ...] 

DEL libname membernamel [membername2. . . ] 

MAP libname [ (options. ..[) ]] 



o£ t i o n s : 

r i 
| TERM | 
| DISK | 
| PRINT | 

L J 



w h er e : 
GEN 

ADD 

DEL 

MAP 
libname 



creates a TXTLIB on your A-disk. If a TXTLIB with the same 
name already exists, it is replaced. 

adds TEXT files to the end of an existing TXTLIB on your 
A-disk. No checking is done for duplicate names, entry points 
or CSECTs. 

deletes members from a TXTLIB on your A-disk, and compresses 
the TXTLIB to remove unused space. If more than one member 
exists with the same name, only the first entry is deleted. 

lists information about TXTLIB members, including their names 
(entry points) , locations in the library, and size. 

specifies the filename of a file with a filetype of TXTLIB, 
which is to be created or listed, or from which members are to 
be deleted or added. 



f n1 [fn. . ] 

specifies the names of files with a filetype of TEXT, that you 
want to add to a TXTLIB. 

membernamel [ membername2 ] 

specifies the names of TXTLIB members that you want to 
delete. 

Options : 

TERM displays information about the TXTLIB on your terminal. 

DISK writes a CMS file, named libname MAP A5, that contains a list 
of TXTLIB members. 

PRINT spools a copy of the TXTLIB map to the virtual printer. 

Usage Notes 

1. When a TEXT file is added to a library, its membername (s) are taken 
from the CSECT names or NAME statements in the TEXT file. Deletions 
and LOAD or INCLUDE command references must be made on these 
names. For example, a TEXT file with a filename of TESTPROG that 
contains CSECTs named CHECK and RECHECK, when added to a TXTLIB, 
creates members named CHECK and RECHECK. 
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2. If you want your TXTLIBs to be searched for missing subroutines 
during CMS loader processing, you must identify the TXTLIB on a 
GLOBAL command, for example 

global txtlib newlib 

3. You may add OS linkage editor control statements NAME, ALIAS, 
ENTRY, and SETSSI to a TEXT file before adding it to a TXTLIB. You 
must follow OS linkage editor conventions concerning format (column 
1 must be blank) and placement within the TEXT file. 

4. TXTLIB members are not fully link-edited, and may return erroneous 
entry points during dynamic loading. 

5. The total number of members in the TXTLIB file cannot exceed 1000. 
When this number is reached, an error message is displayed. The 
text library created includes all the text files entered up to (but 
not including) the one that caused the overflow. 

Responses • 

When the TXTLIB MAP command is issued with the TERM option, the contents 
of the directory of the specified text library are displayed at the 
terminal. The number of entries in the text library (xxx) is also 
displayed. 

ENTRY INDEX 
name location 



XXX ENTRIES IN LIBRARY 

Other Messages and Return Codes 

DMSLBT001E NO FILENAME SPECIFIED RC=24 

DMSLBT002E FILE 'fn ft 1 NOT FOUND RC=28 

DMSLBT002W FILE »fn ft 1 NOT FOUND RC=4 

DMSLBT003E INVALID OPTION •option 1 RC=24 

DMSLBT013E MEMBER 'name' NOT FOUND IN LIBRARY • f n ft fm' RC=32 

DMSLBT014E INVALID FUNCTION 'function' RC=24 

DMSLBT0U6E NO LIBRARY NAME SPECIFIED RC=24 

DMSLBT047E NO FUNCTION SPECIFIED RC=24 

DMSLBT056E FILE • f n ft fm» CONTAINS [ NAME | ALIAS | ENTRY | ESD ] INVALID 

RECORD FORMATS RC=32 
DMSLBT056H FILE • f n ft fm' CONTAINS [{ NAME | ALIAS | ENTRY | ESD } ] INVALID 

RECORD FORMATS RC=4 
DMSLBT104S ERROR • nn • READING FILE ' f n ft f m ' FROM DISK RC=100 
DMSLBT105S ERROR 'nn' WRITING FILE • f n ft fm» ON DISK RC=100 
DMSLBT106S NUMBER OF MEMBER NAMES EXCEEDS MAX 'nnnn'. FILE • f n ft' NOT 

ADDED RC=88 
DMSLBT213W LIBRARY ' f n ft fm' NOT CREATED RC=4 
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Use the TYPE command to display all or part of a CMS file at the 
terminal in either EBCDIC or the hexadecimal representation of the 
EBCDIC code. The format of the TYPE command is: 



I 

J Type 



r r ti 

fn ft [fm] | red |recn|| [ (options. ..[) ] ] 

* I * 1*11 

111 II 

L L J. J 



o£t ion s : 

r r n 

[HEX] |COL J xxxxxl-lyyyyy | | 

I 11/ ll£ecl|| 

L L J J 



r t 

MEMBER f * ) | 



f * II 
( name J | 



i 



w her e : 

fn 

ft 

f m 

red 



recn 



is the filename of the file to be displayed. 

is the filetype of the file to be displayed. 

is the filemode of the file to be displayed. If this field is 
omitted, the A-disk and its extensions are searched to locate 
the file. If fm is specified as an asterisk (*) , all disks are 
searched, and the first file found is displayed. 

is the record number of the first record to be displayed. This 
field cannot contain special characters. If red is greater 
than the number of records in the file, an error message is 
displayed. If this field is omitted or entered as an asterisk, 
a record number of 1 is assumed. 

is the record number of the last record to be displayed. This 
value cannot contain embedded commas. If this field is not 
specified, is entered as an asterisk, or is greater than the 
number of records in the file, displaying continues until 
end-of-file is reached. 



0p_ t ion s : 



COL xxxxx-yyyyy 

displays only certain columns of each record, xxxxx specifies 
the start column and yyyyy the end column of the field within 
the record which is to be displayed. The string xxxxx-yyyyy 
may have a maximum of 8 characters; additional characters are 
truncated. 

If columns are not specified, the entire record is displayed 
unless the filetype is LISTING, in which case the first 
position of each record is not displayed, since it is assumed 
to be a carriage control character. 



HEX 



displays the file in hexadecimal format. 
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MEMBER 
MEM 



I name J 



displays member (s) of a library. If ft is MACLIB or TXTLIB, a 
MEMBER entry can be specified. If an asterisk (*) is 
specified, all members of the library are displayed. If a name 
is specified, only that particular member is displayed. 

Responses 

The file is displayed at the terminal according to the given 
specifications. When you use the HEX option, each record is preceded by 
a header record: 

RECORD nnnnn LENGTH=nnnnn 

Other Messages and Return Codes 

DMSTYP002E FILE • f n ft fm' NOT FOUND RC=28 

DMSTYP003E INVALID OPTION 'option* RC=2U 

DMSTYP005E NO 'option 1 SPECIFIED RC=2U 

DMSTYP009E COLUMN 'col' EXCEEDS RECORD LENGTH RC=24 

DMSTYP013E MEMBER 'name' NOT FOUND IN LIBRARY RC=32 

DMSTYP029E INVALID PARAMETER 'parameter* [IN THE OPTION 'option' FIELD] 

RC=24 
DMSTYP033E FILE ' f n ft fm» IS NOT A LIBRARY RC=32 
DMSTYP039E NO ENTRIES IN LIBRARY * f n ft fm* RC=32 
DMSTYP049E INVALID LINE NUMBER • line number' RC=2U 
DMSTYP054E INCOMPLETE FILEID SPECIFIED RC=24 
DMSTYP062E INVALID * IN FILEID RC=20 
DMSTYP104S ERROR • nn • READING FILE • f n ft fm' FROM DISK RC=100 
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Use the UPDATE command to modify program source files. The source files 
should be stored as 80-character card-image files with sequence fields 
in record positions 73 to 80. The UPDATE command accepts a source input 
file and one or more files containing update control statements and 
update source records. The UPDATE command creates an updated source 
output file, an update log file indicating what changes, if any, were 
made, and an update record file if more than a single update file is 
applied to the input file. 

Updates may be applied either permanently (that is, the updated 
output file replaces the source input file) , or temporarily, in which 
case the updated output file has the name $fn, where fn is the file name 
of the input source file. The format of the UPDATE command is: 



Update 



fn1 |ft1 



|fm1 [fn2 [ft2 [fm2]]]| | [ (options ...[ ) ]] 



| ASSEMBLE 

L 


L 




II 
JJ 




options : 


r i 
I REP | 
1 NOREP | 
c ~ J 


I SE0.8 | 
|N0SEQ8| 

L J 


r i 
|INC | 

1 »oinc 1 

L "" J 


r t 

|CTL | 
| NOCTL | 

L J 




r i 

|STK | 
1 NOSTK | 

L ~" J 


r t 
|TERM | 
| NOTERMI 

L J 


r t 

|DISK | 
| PRINT | 

L J 


r i 

ISTOR 1 
INOSTORJ 

L J 



where: 



fn1 ft1 fm1 



fn2 ft.2 fm2 



is the file identifier of the source input file. If the 
filetype or filemode are omitted, ASSEMBLE and A1 are 
assumed, respectively. 



is the file identifier of the file containing the update 
control statements and updated source records, or, if the 
CTL option is specified, specifies the filename, filetype, 
and filemode of the update control file to be used for a 
multiple update. The defaults are fn1 UPDATE A1 if NOCTL is 
in effect, and fn1 CNTRL A1 if CTL is specified. 



(Dp t ion s : 



REP 



replaces the source input file with the updated source 
file. 



NCREP 



retains the old file in its original form, and assigns a 
different filename to the new file, consisting of a 
dollar sign ($) plus the first 7 characters of the input 
filename (fn1) . 



SEQ8 



specifies that the entire sequence field (columns 73 
through 80) contains an 8-digit sequence number on every 
record of source input. 
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N0SEQ8 specifies that columns 73-75 contain a 3-character label 
field, and that the sequence number is a 5-digit value in 
columns 76-80. 



INC 



NOINC 



CTL 



puts sequence numbers in columns 73 through 80 of each 
updated record inserted from the update file. 

puts asterisks (********) in the sequence number field of 
each updated record inserted from the update file. 

specifies that fn2, ft2, and fm2 describe an update 
control file for applying multiple update files to the 
source input file (see "The CTL Option") . 



Not§2 The CTL option implies the INC option. 



J12CTL specifies that a single update file is to be applied to 
the source input file. 

STK stacks information resulting from a multiple update at 

your CMS console. This information can then be read by a 

CMS EXEC procedure. STK is used only with the CTL 
option. 

NCSTK specifies that no external communication of the multiple 
update results is desired. 

TERM displays warning messages at the terminal whenever a 
sequence or update control card error is discovered. 
(Such warning messages appear in the update log, whether 
they are displayed at the terminal or not.) 

NOTERM suppresses the display of warning messages at the 
terminal. However, error messages which terminate the 
entire update procedure are displayed at the terminal. 

DISK places the update log file on disk. This file has a file 
identifier "fn UPDLOG", where "fn" is the filename of the 
file being updated. 

PRINT prints the update log file directly on the virtual 
printer. 

STOR specifies that the source input file is to be read into 
storage and the updates performed in storage prior to 
placing the updated source file on disk. This option is 
meaningful only when used in conjunction with CTL option 
since the benefit of increased processing speed is 
realized when processing multiple updates. STOR is the 
default when CTL is specified. 

NOSTOR specifies that no updating is to take place in storage. 
NOSTOR is the default when performing single updates or 
when CTL is omitted from the command line. 
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Control Statements 

The UPDATE control statements let you insert, delete and replace source 
records, as well as resequence the output file. All UPDATE control 
statements are identified by the characters • ./• in columns 1 and 2 of 
the 80-byte record, followed by one or more blanks and a maximum of six 
additional, blank-delimited fields. Control statement data must not 
extend beyond column 50. All references to the sequence field of an 
input record refer to the numeric data in columns 73-80 of the source 
record, or columns 76-80 if N0SEQ8 is specified. Leadinq zeros in 
sequence fields are not required. If no sequence numbers exist in an 
input file, a preliminary UPDATE with only the './ S 1 control statement 
can be used to establish file sequencinq. 

Any sequence fields in the update control statements are iqnored; if 
the MOINC option is specified, all sequence fields in the update file 
are iqnored, includinq those on inserted records. If the INC option is 
specified, sequence fields for the inserted records are either qenerated 
by UPDATE, if the dollar-siqn ($) delimiter is used, or are included 
intact from the update file if the dollar siqn ($) is not used. 

Chanqes are made sequentially in a sinqle pass throuqh the input and 
update files; an error condition results if any sequence errors occur in 
the update control statements, and warninqs are issued if an error is 
detected in the sequencinq of the input file. Any source input records 
with a sequence field of eiqht blanks are skipped, without any 
indication of a sequence error. Such records may be replaced or deleted 
only if they occur within a ranqe of records that are beinq replaced or 
deleted entirely and if that ranqe has limits with valid sequence 
numbers. There is no means provided for specifyinq a sequence field of 
blanks on an update control statement. 



Control Statement Formats 

SEQUENCE Control Statement — resequences the updated source output file 
in columns 73-80 (if SEQ8 is specified) , or in columns 76-80 with the 
label placed in columns 73-75 (if NOSEQ8 is specified) . If this 
statement is included in the update file, it must be the first control 
statement. The format of the SEQUENCE control statement is: 

[seqincr [label]]] | 

w here : 

seqstrt is a 1- to 8-diqit numeric field specifyinq the first 
decimal sequence number to be used. The default value 
is 1000 if SEQ8 is specified and 10 if NOSEQ8 is 
specified. 

seqincr is a 1- to 8-diqit numeric field specifyinq the decimal 
increment for resequencinq the output file. The 
default is the •seqstrt' value. 

label is a 3-character field to be duplicated in columns 
73-75 of each source record if N0SEQ8 is specified. 
The default value is the first three characters of the 
input filename (fn1). 
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An error is indicated if any valid control statement precedes the 
./ S statement in the update file, and the resequence operation is 
suppressed. 



Each source record is resequenced in columns 73-80 as it is written 
onto the output file. Unchanqed records from the input file and records 
inserted from the update file are resequenced. 

INSERT Control Statement — inserts all records following it, up to the 
next control statement, into the output file. The format of the INSERT 
control statement is: 



| ./ I segno [$ [seqstrt [seqincr]]] 



w her e : 

seqno is the sequence number of the source input record 
following which the insertion is to be made. 

$ is an optional delimiter indicating that the inserted 

records are to be sequenced by increments. 

seqstrt is a 1- to 8-digit numeric field specifying the first 
decimal number to be used for seguencing the inserted 
records. 

seqincr is a 1- to 8-digit numeric field specifying the decimal 
increment for sequencing the inserted records. 

All records following the " ./ I" statement, up to the next control 
statement, are inserted in the output file following the record 
identified by the "segno" field. If the NOINC option is specified, each 
inserted record is identified with asterisks (********) in columns 
73-80. If either the INC or CTL option is specified, the records are 
inserted unchanged in the output file, or they are sequenced according 
to the "segstrt" and "seqincr" fields, if the dollar sign ($) key is 
specified. 

The default sequence increment, if the dollar sign is included, is 
determined by using one tenth of the least significant, nonzero digit in 
the segno field, with a maximum of 100. The default seqstrt is computed 
as seqno plus the default seqincr. For example, the control statement: 

./ I 2600 $ 2610 

causes the inserted records to be sequenced XXX02610, XXX02620, and so 
forth (NOSEQ8 assumed here) . For the control statement: 

./ I 240000 $ 

the defaulted segincr is the maximun, 100, and the starting sequence 
number is 240100. SEQ8 is assumed, so the inserted records are 
sequenced 00240100, 00240200, and so forth. 

If either INC or CTL is specified but the dollar sign is not 
included, whatever sequence number appears on the inserted records in 
the update file is included in the output file. 
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5IIsJTE Control Statement — deletes one or more records from the source 
file. The format of the DELETE control statement is: 



| ./ D seqnol [ seqno2 ] [$] | 

where: 

seqnol is the sequence number identifyinq the first or only 
record to be deleted. 

seqno2 is the sequence number of the last record to be 
deleted. 

$ is an optional delimiter indicatinq the end of the 

control fields. 

All records of the input file, beqinninq at seqnol , are deleted from 
the output file, up to and including the seqno2 record. If the seqno2 
field is omitted, only a sinqle record is deleted. 

SJPLACE Control Statement — replaces one or more input records with 
updated records from the update file. The format of the REPLACE control 
statement is: 



| ./ R seqnol [seqno2] [$ [seqstrt [seqincr]]]| 

where : 

seqnol is the sequence number of the first input record to be 
replaced. 

seqno2 is the sequence number of the last record to be 
replaced. 

$ is an optional delimiter key indicatinq that the 

substituted records are to be sequenced incrementally. 

seqstrt is a 1- to 8-diqit numeric field specifyinq the first 
decimal number to be used for sequencing the 
substituted records. 

seqincr is a 1- to 8-diqit numeric field specifyinq the decimal 
increment for sequencinq the substituted records. 

All records of the input file, beqinninq with the seqnol record, up 
to and includinq the seqno2 record, are replaced in the output file by 
the records followinq the " ./ R" statement in the update file, up to the 
next control statement. As with the "./ D" (delete) function, if the 
seqno2 field is omitted, only a sinqle record is replaced, but it may be 
replaced by more than a sinqle inserted record. The "./ R" (replace) 
function is performed as a delete followed by an insert, such that the 
number of statements inserted need not match the number deleted. The 
dollar siqn ($) , seqstrt, and seqincr processinq is identical to that 
for the insert function. 
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COMMENT Statements — The format of the COMMENT statement is: 
I •/ * [comment] 

where : 

* indicates that this is a comment statement, and is to 

be ignored, except that it is copied into the log 
file. 

Summary of Input and Output Files for the UPDATE Command 

The following discussions describe the files used and created by the 
UPDATE command, and the placement of the files created. 

lUEUt Ziies When a Single Update Is to Be Applied: When the CTL option 
is not specified in the UPDATE command line, only one update is applied 
to the source file. The input files are: 

• The source file, which is to be updated. The filename of this file 
must be specified in the command line. The filetype and filemode 
default to ASSEMBLE and A1, respectively, unless overridden by the 
command line. 

• The update file, whose control statements have been described under 
"Control Statement Formats." The filename of this file defaults to 
the filename of the source file, and the filetype and filemode 
default to UPDATE and A1, respectively. All three may be overridden 
by the command line. 

OJSiPJii Iii§s Wlieji a Single Update Is Applied: When a single update is 
applied to the source file, the following output files are created: 

• An updated source file is created. "$fn" becomes the name of this 
file, where "fn" is the filename of the original source file, unless 
the REP option is specified. When the REP option is specified, the 
filename of this file becomes "fn". (For exceptions, see "Warning 
and Error Handling") . 

• An update log, showing all transactions and errors, is created. The 
filename of the file is the filename of the original source file, and 
the filetype of this file is UPDLOG. Note, however, that if the 
PRINT option is specified with the command line, then the update log 
is printed directly on the virtual spooled printer, and no disk file 
is created. 

IS£ut Files When Multilevel Updates Are Applied: When the CTL option is 
specified on the command line, multilevel updates are applied to the 
source file. In this case, the following files are input to the UPDATE 
command: 

• A source file, specified in exactly the same way as the source file 
for a single update. 

• A control file that controls what updates are applied, and the order 
in which they are to be applied. The filename of this file defaults 
to the filename of the source file, and the filetype and filemode 
default to CNTRL and A1, respectively. All three may be overridden 
by the command line. This file contains, in its control statements. 
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pointers to update files, PTF files, and auxiliary files (these are 
described under "The CTL Option") . 

• One or more update files, as specified by the control file. The 
filename of these files is the same as the filename of the source 
file. The filetype of these files is "UPDTxxxx". 

• Auxiliary files, as specified by the control file. The filename of 
these files is the same as the filename of the source file. The 
filetype of these files is "AUXxxxx". The filetype can be specified 
as either ' AUXnnnn' or * nnnn AUX'. If you use the second form, the 
first three characters may not be ' AUX". The auxiliary files contain 
additional control statements pointing to PTF files. The format of 
the auxiliary files is described under, "The CTL Option." 

• PTF files, as specified by either the control file or the auxiliary 
files. The filename of these files is the same as the filename of 
the source file. The filetype is specified in full by the control 
file or the auxiliary file. In format, these files are identical to 
ordinary update files. 

Output Files When Multilevel Updates Are Applied: When the CTL option is 
specified, the following output files are created by the UPDATE command: 

• An updated source file, as in the case of a single update. 

• An update log, as in the case of a single update. 

• An UPDATES file. This file has the filename of the original source 
file, and a filetype of UPDATES. It contains information summarizing 
the updates that were applied to the file, and that are to be 
concatenated onto the assembly text deck for documentation and 
information. 

• Although not a disk file, additional output is produced in the form 
of lines placed in the terminal read stack, for interrogation by an 
EXEC file which may have invoked the UPDATE command. These lines are 
placed there only if the STK option is specified. 

£i§]£ I2§§ 2f OuJ-BllJi Iii§s: If several read/write disks are accessed when 
the UPDATE command is invoked, the following steps are taken to 
determine the disk upon which the output files are to be placed (the 
search stops as soon as one of the following steps is successful) : 

1. If the disk on which the original source file resides is 
read/write, then the output files are placed on that disk. 

2. If that disk is a read-only extension of a read/write disk, then 
the output files are placed on that particular read/write disk. 

3. Otherwise, the output files are place on the primary read/write 
disk (the A-disk) . 

I^e CTL Option 

If the NOCTL option is specified or defaulted, UPDATE processes one 
input file and one update file to produce an updated source output file 
and an update log file containing a record of what changes were made. 
This mode of operation is suitable for testing modifications prior to 
incorporating them in the base source code, providing that only one set 
of changes has to be tested at a time. If, for any reason, more than 
one set of changes is outstanding against a single source input file, 
the difficulties in managing that base code can multiply very rapidly. 
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For this reason, UPDATE provides the CTL option, which has a multilevel 
update control and management scheme developed for updating VM/370 
distributed source code, and may be used wherever its advantages are 
felt. 

The major components of the multilevel update scheme are: 

• A set of base source code which is not permanently changed. 

• A set of update files for each source file that must be applied in a 
specific order. 

• One or more CNTRL files that describe the order or priority of 
updates to be applied to each source file. 

• Optionally, one or more auxiliary control files, each pertaining to a 
specific source file. 

An integral part of the multilevel update scheme is a naming 
convention for the update files themselves, and for any TEXT files 
produced by assembling or compiling the updated output files. In normal 
usage, any update file has the filename of the source file to which it 
applies and the filetype of UPDATE. When the CTL option is used to 
invoke the multilevel update controls, the filename usage becomes a 
requirement, such that the update files must have the filename of the 
source file to which they apply, but the filetypes are modified to 
distinguish between separate update levels. The filetype for an update 
file is constructed from UPDT plus a 1- to U-character update 
identifier. For example, if the command 

UPDATE DMSUPD ASSEMBLE Al X4 CNTRL A1 (CTL 

is issued, the source file is DMSUPD ASSEMBLE A1 and the control file is 
X4 CNTRL A1. Assume that the control file contains three update files, 
named "DMSUPD UPDT750", "DMSUPD UPDTX4", and "DMSUPD UPDT009." The 
CNTRL file specifies which update files are to be applied to the source 
file and in what order they are to be applied, on the basis of the 
update identifier. Another identification parameter, the update level 
identifier, is used when naming a TEXT file produced from the updated 
source file. The update level identifier is specified by the CNTRL file 
and is associated with a specific update identifier, also in the CNTRL 
file. For example, in applying the preceding update to DMSUPD ASSEMBLE, 
a file named X4 CNTRL might appear as follows: 

00D MACS DMSLIB SYSLIB 

X4D UPDTX4 

75X UPDT750 

009X UPDT009 

This control file applies the updates DMSUPD UPDT009, DMSUPD UPDT750, 
and DMSUPD UPDTX4, in that order, to the file DMSUPD ASSEMBLE. The 
updates are applied in reverse order as they appear in the CNTRL file, 
that is, the lowest level of update is at the bottom of the file, and 
the highest level update is at the top. As the CNTRL file and update 
files are processed, the UPDATE command displays the following message 
at the terminal: 

DMSUPD178I UPDATING [»fn ft fm»] WITH • f n ft fm« 

for each update file which is applied to the source input during the 
multilevel update; the bracketed expression is displayed only for the 
first update. 

In the preceding example, the fields X<4D, 75X, and 009X are the 
update level identifiers, associated with the UPDTX4, UPDT750, and 
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UPDT009 update identifiers, respectively. According to the naming 
convention for VM/370 TEXT files, the result of assembling the updated 
$DMSUPD ASSEMBLE file would be named DMSUPD TXTX4D, where the X4D is the 
update level identifier of the highest-level update applied. The TXT 
portion of the filetype indicates that this is a TEXT file, but allows 
up to a 5-character update level identifier. 

For more information on using update control files, see the VM/370: 
Hi3JJJS!il!3 and System Generation Guide. 

Ike STK/NOSTK Options 

The STK option is provided for use with the multilevel update invoked 
via the CTL option, primarily for communication with CMS EXEC procedures 
which invoke UPDATE. If the CTL and STK options are specified, UPDATE 
places two lines of data in the CMS terminal read stack, as follows: 

first line = * update level identifier 

second line = * library list from "MACS* record 

These lines are placed in the terminal read stack via the CMS ATTN 
function, and are available to an invoking EXEC procedure via the EXEC 
control words &READ ARGS or &READ VARS. The first line, the update 
level identifier, is the level identifier of the highest level update 
applied; this is the TEXT file f iletype-modif ier used by the VM/370 
update procedures. The second line consists of the list of libraries 
specified on the MACS record in the CNTRL file. The library search 
order for an assembly or compilation can be established by issuing the 
GLOBAL command using the library list returned. 

If the NOSTK option is used with the multilevel update, no data is 
made available to external procedures and the update level identifier 
has no meaning. 

Example of Multilevel Update 

If the command 

update proga assemble * proga cntrl * (ctl stk) 
is issued and the contents of the PROGA CNTRL file are : 

* THIS IS AN EXAMPLE OF A CONTROL FILE 
00D MACS MYLIB SYSLIB 

* FIX FOR SAVING ALL REGISTERS 
00A UPDTLVL4 
PTF A7300DMS 

* AUX FILE CONTAINING UPDATES FOR B1 FEATURE 
OOB AUXLVL3 



and the contents of the PROGA AUXLVL3 file are : 



| * PTF A2330DMS CONTAINS FUNCTIONAL CODE FOR B1 

| PTF A2330DMS 

| * PTF A0915DMS CONTAINS ERROR MESSAGES FOR B1 

| PTF A0915DMS 

i 
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The following files are used to update PROGA ASSEMBLE in the order 
indicated. 

liiSS^me Iiiety.pe 

PROGA A0915DMS 

PROGA A2330DHS 

PROGA A7300DMS 

PROGA UPDTLVL4 



The resultant output file $PROGA ASSEMBLE contains the updates from 
the four files listed. In addition, two lines are placed in front of 
the CMS terminal read stack: 

* 00A 

* MYLIB SYSLIB 

If the UPDATE command shown was issued from an EXEC procedure and 
followed by the EXEC commands: 

&READ VARS &I1 &I2 
&READ VARS &I3 &I4 &I5 

then 

611 = * 

612 = 00A 

613 = * 

614 = MYLIB 

615 = SYSLIB 

In this example, the UPDATE command was entered from the terminal and 
the stacked lines are ignored by CMS. 

I^ffiiSSI and Error Handling 

The UPDATE command detects a number of invalid requests, and decides 
whether they should be treated as warning situations or as errors. The 
following general description shows the handling of these situations, 
and the return codes associated with each situation. 

Sequencing and Update Control Card Errors: These errors are treated as 
"warning situations." That is, a warning message is generated, and 
processing continues. The warning messages are printed in the update 
log, and are displayed on the terminal unless the NOTERM option is 
specified in the command line. The errors are: 

• Input sequencing errors (return code = 4) . The input source file 
contains sequence errors (that is, one or more control cards are not 
in ascending order) . 

• Output sequencing errors (return code = 8) . The updating procedure 
introduces new sequencing errors into the output source file. 

• Invalid update control statements (return code = 12) . The update 
file contains invalid control statements. Erroneous statements in 
control files cause the update procedure to terminate. 

If more than one such error is detected, the UPDATE command returns 
the highest return code (4, 8, or 12) encountered. 
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If any such error is detected, the REP option, if specified, is 
ignored, and the update source file retains the filename "$fn", as if 
NOREP was in effect. 

Q£lk§£ l££2£s: Other errors are invalid control file statements, invalid 
file formats, and disk input/output errors. The UPDATE command 
processing is terminated as soon as the error is detected. The return 
code is always 20 or greater. 

If any such error is detected, the update file is left with the 
filename UPDATE and the filetype CMSUT1, so that you may examine or 
otherwise make use of it. This file must be erased before the UPDATE 
command can be invoked again. 

Responses 

FILE • fn ft fm,» REC #n = update control statement 

This message is displayed when the TERM option is specified and an 
error is detected in an update file. It identifies the file and 
record number where the error is found. 

DMSUPD177I WARNING MESSAGES ISSUED (SEVERITY=nn) . ['REP 1 OPTION 
IGNORED. ] 

Warning messages were issued during the updating process. The 
severity shown in the error message in the • nn* field is the 
highest of the return codes associated with the warning messages 
which were generated during the updating process. 

The warning return codes have the following meanings: 

RC = 4; Seguence errors were detected in the original source file 
being updated. 

RC = 8; Seguence errors which did not previously exist in the 
source file being updated were introduced in the output file 
during the updating process. 

RC = 12; Any other nonfatal error detected during the updating 
process. Such errors include invalid update file control 
statements, and missing PTF files. 

The severity value is passed back as the return code from the 
UPDATE command., In addition, if the REP option is specified in 
the command line, then it is ignored, and the updated source file 
has the fileid H $fn1 ft1", as if the REP option was not 
specified. 

DMSUPD178I UPDATING ['fn ft fra»] WITH «fn ft fm» 

The specified update file is being applied to the source file. 
This message appears only if the CTL option is specified in the 
command line. The updating process continues. 
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| DMSUPD304I UPDATE PROCESSING WILL BE DONE USING DISK 

| An insufficient amount of virtual storage was available to perform 

| the updating in virtual storage, so a CMS disk must be used. This 

| message is displayed only if NOSTOR was specified in the UPDATE 

| command line. 

Other Messages and Return Codes 

DMSUPD001E NO FILENAME SPECIFIED RC=4 

DMSUPD002E FILE «fn ft fm' NOT FOUND RC=28 

DMSUPD003E INVALID OPTION 'option 1 RC=24 

DMSUPD007E FILE »fn ft fm» IS NOT FIXED, 80 CHAR. RECORDS RC=32 

DMSUPD010W PREMATURE EOF OF FILE • f n ft fm' — SEQ NUMBER • • NOT 

FOUND RC=12 

| DMSUPD024E FILE 'UPDATE CMSUT1 fm' ALREADY EXISTS RC=28 

DMSUPD037E DISK 'mode' IS READ/ONLY RC=36 

DMSUPD048E INVALID MODE 'mode' RC=24 

DMSUPD065E 'option' OPTION SPECIFIED TWICE RC=24 

DMSUPD066E 'option' AND 'option' ARE CONFLICTING OPTIONS RC=24 

DMSUPD069E DISK 'mode' NOT ACCESSED RC=36 

DMSUPD070E INVALID PARAMETER 'parameter' RC=24 

DMSUPD104S ERROR »nn' READING FILE • f n ft fm» FROM DISK RC=100 

DMSUPD105S ERROR • nn • WRITING FILE »fn ft f m ' ON DISK RC=100 

DMSUPD174W SEQUENCE ERROR INTRODUCED IN OUTPUT FILE: • ' TO 

• • RC=8 

DMSUPD176W SEQUENCING OVERFLOW FOLLOWING SEQ NUMBER' • RC=8 

DMSUPD179E MISSING OR DUPLICATE 'MACS' CARD IN CONTROL FILE ' f n ft fm» 

RC=32 

DMSUPD180W MISSING PTF FILE • f n ft fm' RC=12 

DMSUPD181E NO UPDATE FILES WERE FOUND RC=U0 

DMSUPD182W SEQUENCE INCREMENT IS ZERO RC=8 

DMSUPD183E INVALID { CONTROL | AUX } FILE CONTROL CARD RC=32 

DMSUPD184W »./S • NOT FIRST CARD IN INPUT FILE — IGNORED RC=12 

DMSUPD185W INVALID CHAR IN SEQUENCE FIELD ' • RC=12 

DMSUPD186W SEQUENCE NUMBER • • NOT FOUND RC=12 

DMSUPD187E OPTION 'STK' INVALID WITHOUT «CTL» RC=24 

DMSUPD207W INVALID UPDATE FILE CONTROL CARD RC=12 

DMSUPD210W INPUT FILE SEQUENCE ERROR: • • TO • • RC=4 

| DMSUPD299E INSUFFICIENT STORAGE TO COMPLETE UPDATE RC=40 

I DMSUPD300E INSUFFICIENT STORAGE TO BEGIN UPDATE RC=40 
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I Immediate Commands 



You can issue an Immediate command only after causing an attention 
interrupt by pressing the Attention key (or its eguivalent) . These 
commands are processed as soon as they are entered. They are also 
executed immediately when they are stacked in an EXEC procedure. Any 
program execution in progress is suspended until the Immediate command 
is processed. 

None of the Immediate commands issue responses. 



HB 



Use the HB command to stop the execution of a CMS batch virtual machine 
at the end of the current job. The format of the HB Immediate command 
is: 



I HB | 



Usage Notes 

1. If the batch virtual machine is running disconnected, it must be 
reconnected. 

2. When the HB command is executed, CMS sets a flag such that at the 
end of the current job, the batch processor generates accounting 
information for the current job and then logs out the CMS batch 
virtual machine. 



HO 



Use the HO command during the execution of a command or one of your 
programs to stop the recording of trace information. Program execution 
continues to its normal completion, and all recorded trace information 
is spooled to the printer. The format of the HO command is: 



| HO | 
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HT 

Use the HT command to suppress all terminal output generated by any CMS 
command or your program that is currently executing. The format of the 
HT command is: 



HT 



Usage Notes 

1. Program execution continues, when the Ready message is displayed, 
normal terminal output resumes. Use the RT command to restore 
typing or displaying. 

| 2. CMS error messages having a suffix letter of W, E, S r or T cannot 
be suppressed. 



HX 

| Use the HX command to stop the execution of any CMS or CMS/DOS command 
or program, close any open files or I/O devices, and return to the CMS 
command environment. The format of the HX command is: 

I HX | | 

i , , 



Usage Notes 

| 1. HX clears all file definitions made via the FILEDEF or DLBL 

| commands, including those entered with the PERM option. 

| 2. The HX command is executed when the next SVC or I/O interrupt 

I occurs, therefore a delay may occur between keying HX and the 

| return to CMS. All terminal output generated before HX is 

| processed is displayed before the command is executed. 



RO 

Use the RO command, during the execution of a command or one of your 
programs, to resume the recording of trace information that was 
temporarily suspended by the SO command. Program execution continues to 
its normal completion, and all recorded trace information is spooled to 
the printer. The format of the RO command is: 

I RO | I 
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RT 



Use the RT command to restore terminal output from an executing CMS 
command or one of your programs that was previously suppressed by the HT 
command. The format of the RT command is: 



| RT | 



Usage Notes 

1. Program execution continues, and displaying continues from the 
current point of execution in the program. Any terminal output 
that is generated after the HT command is issued and up to the time 
the RT command is issued is lost. Execution continues to normal 
program completion. 



SO 



Use the SO command during the execution of a command or one of your 
programs to temporarily suspend the recording of trace information. 
Program execution continues to its normal completion and all recorded 
trace information is spooled to the printer. The format of the SO 
command is: 



SO 



Usage Notes 
1. To resume tracing, issue the RO command. 
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Section 3: EDIT Subcommands and Macros 



This section describes the formats and operands of the EDIT subcommands 
and macros. EDIT subcommands are valid only in the environment of the 
CMS Editor, which is invoked with the EDIT command. The EDIT command 
format is described in "Section 2. CMS Commands." 

The editor has two modes of operation: edit mode and input mode. 
Whenever the EDIT command is issued, edit mode is entered; when the 
INPUT or REPLACE subcommands are issued with no operands, input mode is 
entered. In input mode, all lines you enter are written into the file 
you are editing. To return to edit mode from input mode, you must enter 
a null line (one that has no data on it) . 

For a functional description of the CMS Editor, and tutorial 
information on using it, consult the VM/370: CMS User^s Guide. 

For a summary of the default settings assumed by the editor for CMS 
reserved filetypes, see "Appendix A: Reserved Filetype Defaults." 



EDIT Subcommands 

The EDIT subcommands are listed in alphabetical order for easy 
reference. Each subcommand description includes the format, a list of 
operands (if any) , usage notes, and responses. For those subcommands 
that operate somewhat differently on a 3270 terminal than on a 
typewriter terminal, an additional dicussion, "Display Mode 
Considerations, " is added. 

Subcommands that are valid only with 3270 terminals, namely SCROLL, 
SCROLLOP and FORMAT have the notation " (3270 only) " next to the 
subcommand names. The FORWARD and BACKWARD subcommands, which were 
designed for use with 3270 terminals but can be issued at any terminal, 
have the notation "(primarily 3270)" next to the subcommand names. 
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ALTER 



Use the ALTER subcommand to change a specific character to another 
character, one that may not be available on your terminal keyboard. The 
ALTER subcommand allows you to reference characters by their hexadecimal 
values. The format of the ALTER subcommand is: 



I i 



ALter 



char! char2 



r r n 

In I G | | 

I* l*ll 

\1 I II 

L L JJ 



where : 
charl 

char2 



I G 



specifies the character to be altered. It may be specified 
either as a single character or as a pair of hexadecimal digits 
(00 through FF) . 

specifies the character to which charl is to be altered. It may 
be specified either as a single character or as a pair of 
hexadecimal digits. 

indicates the number of lines to be searched for the specified 
character. If you specify an asterisk (*) , all lines in the 
file, beginning with the current line, are searched. If this 
option is omitted, then only the current line is searched. 

reguests the editor to alter every occurrence of charl in the 
lines specified. If G or * is not specified, only the first 
occurrence of charl in each line specified is altered. 



fiscal! MS^es 
1 



If char2 is a hexadecimal value that cannot be represented on your 
terminal, the character space it occupies appears blank. For 
example, 

input XSLC 
alter X 02 
SLC 



2. 



Column 1 contains a X"02', which cannot be displayed. 

Use the ZONE subcommand if you want only particular columns 
searched for a specific character. 



Responses 

When verification is on, each line that is altered is displayed at your 
terminal. 
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AUTOSAVE 



Use the AUTOSAVE subcommand to set, reset, or display the automatic save 
function of the editor. When the automatic save function is in effect, 
the editor automatically issues the SAVE subcommand each time the 
specified number of changes or insertions are made. The format of the 
AUTOSAVE subcommand is: 



| | AUTOsave 
I I 



I r t 

I in | 

I I Oil I 

I L J 



_™ I 



where : 

n is a decimal number between 1 and 32767, indicating the frequency 
of the automatic save function. One SAVE subcommand is issued for 
every n lines that are changed, deleted, or added to the file. 

OFF turns off the automatic save function. 

H§§3§ Notes 

1. Each line affected by the $MOVE macro is treated as one update. 
However, all changes caused by a single CHANGE, DELETE, DSTRING, 
GETFILE, or OVERLAY subcommand are treated as a single update, no 
matter how many lines are affected. 

2. If you do not issue the AUTOSAVE subcommand, the default setting is 
OFF. 

| 3. If you are editing a file on a read— only disk, and an automatic 
| save request occurs, the message 

| SET NEW FILEMODE AND RETRY 

| is issued. You can enter CMS subset and access the disk in 

| read/write mode, or use the FMODE subcommand to change the filemode 

| to the mode of a read/write disk. If you were in input mode, you 

| are placed in edit mode. 

4. The message "_SAVED" is displayed at the terminal each time the 
save operation occurs. 

Responses 

If you issue the AUTOSAVE subcommand with no operands, the editor 
displays the current setting of the automatic save function. 
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BACKWARD (Primarily 3270) 

Use the BACKWARD subcommand to move the current line pointer towards the 
beginning of the file you are editing. The format of the BACKWARD 
subcommand is: 



S I r -i I 

| BAckward I |n| | 

I I III I 

I I L J I 

wh er e : 

n is the number of records backward you wish to move the current line 
pointer. If n is not specified, the current line pointer is moved 
up one line, toward the top of the file. 

Usage Notes 

1. The BACKWARD subcommand is equivalent to the UP subcommand; it is 
provided for the convenience of 3270 users. 

Responses 

When verification is on, the new current line is displayed on line 9 of 
the display screen. If n exceeds the number of records in the file 
above the current line, TOF is displayed on line 9. 

On a typewriter terminal the new current line is typed if 
verification is on. 



BOTTOM 

Use the BOTTOM subcommand to make the last line of the file the new 
current line. The format of the BOTTOM subcommand is: 

| Bottom | | 

i 



Usage Notes 

1. Use the BOTTOM subcommand followed by the INPUT subcommand to begin 
entering new lines at the end of a file. 

Responses 

When verification is on, the last line in the file is displayed. 

I Display Mode Considerations 

If the BOTTOM subcommand is issued at a 3270 display terminal in display 
mode, EOF: is displayed on line 10, lines 2 through 9 contain the last 
eight records of the file, and lines 11 through 23 are blank. 
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CASE 



Use the CASE subcommand to indicate how the editor is to process 
uppercase and lowercase letters. The format of the CASE subcommand is: 



| CASE 



I r i 

I IM | 

I IU I 

I L J 



where : 

M indicates that the editor is to accept any mixture of uppercase and 
lowercase letters for the file as they are entered at the 
terminal. 

U indicates that the editor is to translate all lowercase letters to 
uppercase letters before ,the letters are entered into the file. U 
is the default value for all filetypes except MEMO and SCRIPT. 

Responses 

If you enter the CASE subcommand with no operand, the current setting is 
displayed at the terminal. 

I display Mode Considerations 

I If you specify CASE M when using a 3270 that does not have the lowercase 
| feature (RPQ) , you can key in lowercase characters, but they appear on 
I the screen as uppercase characters. 



CHANGE 



Use the CHANGE subcommand to change a specified group of characters to 

another group of characters of the same or a different length. You may 

use the CHANGE subcommand to change more than one line at a time. The 
format of the CHANGE subcommand is: 



Change 



[/string1[/string2[/|n|G| | ]]] 

111 I I 

L L JJ 



where : 

/ (diagonal) signifies any unique delimiting character that does not 
appear in the character strings involved in the change. 

stringl specifies a group of characters to be changed (old data) . 
stringl may be a null string. 

string2 specifies the group of characters that are to replace 
stringl (new data) . string2 may be a null string; if 
omitted, it is assumed null. 
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n or * indicates the number of lines to be searched, starting at 
the current line. If * is entered, the search is performed 
until the end of the file is reached. If this option is 
omitted, then only one line is searched. 

G or * requests the editor to change every occurrence of stringl 
in the lines specified. If G or * is not specified, only 
the first occurrence of stringl in each line specified is 
changed. If stringl is null, G or * may not be specified. 

Usacje Notes 

1. The first nonblank character following the CHANGE subcommand (or 
any of its truncation) is considered the delimiter. For example: 

c. VM/370. CMS.* 

changes the first occurrence of VM/370 to CMS on every line from 
the current line to the end of the file. 

2. If string2 is omitted, it is assumed to be a null string. For 
example, 

THIS ISN THE LINE. 

change /n 

THIS IS THE LINE. 

A null string causes a character deletions. If stringl is null, 
characters are inserted at the beginning of the line, for example, 

THIS IS THE LINE. 

change //SO / 

SO THIS IS THE LINE. 

3. To change multiple occurrences of the same string on one line, 
enter 

change/string1/string2/ 1 * 

4. The CHANGE subcommand can be used on typewriter terminals to 
display, without changing, any lines that contain the information 
specified in stringl. Enter: 

change /string 1/string1/ * * 

5. Use the ZONE subcommand to indicate which columns are to be 
searched for stringl. If stringl is wider than the current zone, 
you receive the message 

ZONE ERROR 

and you should either re-enter the CHANGE subcommand or change the 
zone setting. 

6. If the character string inserted causes the data line to extend 
beyond the truncation column or the zone column, any excess 
characters are truncated. (See the description of the TRDNC 
subcommand for additional information on truncation.) 

7. You should use the ALTER subcommand when you want to change a 
single character to some special character (one that is not 
available on your keyboard) . 
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Responses 

When verification is on, every line that is changed is displayed. 

P±§£iSZ Mode Considerations 

If you issue the CHANGE subcommand without operands at a 3270 display 
terminal in display mode, the following occurs: 

1. The record pointed to by the current line pointer appears in the 
user input area of the display. 

2. You can then alter the record in the user input area by retyping 
part or all of the line, or by using the Insert, Delete, or Erase 
EOF keys to insert or delete characters. 

3. When the line is modified, press the Enter key, which causes the 
record in the user input area to replace the old record at the 
current line in the output display area. 

If you bring a line down to the user input area and decide not to 
change it, press the Erase Input key and then the Enter key, and the 
line is not changed. 

When a line is moved to the user input area, all nonprintable 
characters (including tabs, backspaces, control characters, and so on) 
are stripped from the line. Also, any characters currently assigned to 
VM/370 logical line editing symbols (#,a>,£, ") are reinterpreted when 
the line is reentered. You should issue an explicit CHANGE subcommand 
to change to lines containing special characters. 

The CHANGE subcommand is treated as an invalid subcommand if it is 
issued without operands at a typewriter terminal or at a 3270 display 
terminal that is not in display mode. 

When you reguest a global change on a 3270 terminal, the display is 
changed only once, to reflect the final position of the current line 
pointer. The editor displays, in the message area of the display 
screen: 

(nnnn) LINE(S) CHANGED 
(NO / 

to indicate the number of lines that were updated. If the change 
reguest resulted in the truncation of any lines, the message is 
displayed as: 

nnnn LINE (S) CHANGED nnnn LINE(S) TRUNCATED 

If the change reguest moves the current line pointer beyond the end 
of the file, the word EOF: is displayed on line 9, preceded by the last 
seven records of the file. Lines 10 through 23 are blank. 
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CMS 

Use the CMS subcommand to cause the editor to enter the CMS subset mode, 
where you may execute those CMS commands that do not need to use the 
main storage being used by the editor. The format of the CMS subcommand 
is: 

I CMS | | 

Usage Notes 

| 1 . You can execute any CMS command that is nucleus resident or that 
| executes in the transient area in CMS subset. The nucleus-resident 
CMS commands are: 

CP GENMOD START 

DEBUG INCLUDE STATE 

ERASE LOAD STATED 

FETCH LOADMOD 

The commands that execute in the transient are: 

ACCESS LISTFILE RELEASE 

ASSGN MODMAP RENAME 

COMPARE OPTION SET 

DISK PRINT SVCTRACE 

DLBL PUNCH SYNONYM 

FILEDEF QUERY TAPE 

GENDIRT READCARD TYPE 
GLOBAL 

| To return to edit mode r use the CMS subset command RETURN. 

I 2. If you attempt to execute a CMS command that reguires main storage, 
I you receive the message: 

| INVALID SUBSET COMMAND 

| You should not attempt to execute any program that executes in the 

I user program area. Using the LOAD, INCLUDE (RESET) , FETCH, START, 

| and RUN commands could load programs that would overlay the 

| editor's storage area and its contents. Use these commands only 

| for programs that execute in the transient area. 

| 3. In an edit macro, if you attempt to use a command that is invalid 
| in CMS subset, you receive a return code of -2. 

Responses 

After you issue the CMS subcommand, you receive the message 

CMS SUBSET 

to indicate that you are in CMS subset mode. On a display terminal, the 
screen is cleared before the editor issues this message; the display of 
the file is restored when you enter the RETURN command. 
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DELETE 



Use the DELETE subcommand to delete one or more lines from a file, 
beginning with the current line. The line immediately following the 
last line deleted becomes the new current line. The format of the 
DELETE subcommand is: 



DELete 



r t 
in | 

1*1 
111 

L J 



where : 

n indicates the number of lines to be deleted, starting at the 
current line. If * is entered, the remainder of the file is 
deleted. If n is omitted, only one line is deleted. 

Responses 

None. If you delete the last line in the file, or if you issue the 
DELETE subcommand when the current line pointer is already at the end of 
the file, the editor displays the message 

EOF: 

PisiiElay H2!l® Considerations 

If ybu delete a record when using a display terminal in display mode, 
the editor rewrites the output display area with the top seven records 
unchanged. The bottom 12 records move up by one, and a new record (if 
one exists) moves into the bottom of the output display area (line 23) . 



DOWN 



Use the DOWN subcommand to advance the line pointer forward in the file. 
The line pointed to becomes the new current line. The format of the 
DOWN subcommand is: 



DOwn 



l r t 
I |n| 
I III 



where: 



indicates the number of lines to advance the 
the current line. If it is not specified, 
advanced one line. 



pointer, starting at 
the line pointer is 
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MS3® Notes 
1. DOWN is equivalent to the NEXT and FORWARD subcommands. 

Responses 

When verification is on, the new current line is displayed at the 
terminal; if the end of the file is reached, the message 

EOF: 

is displayed. 

DSTRING 

Use the DSTRING subcommand to delete one or more lines beginning with 
the current line, down to, but not including, the first line containing 
a specified character string. The current line is not checked for the 
character string. The format of the DSTRING subcommand is: 



| DString | /[string[/]] 

i : 



where : 

/ (diagonal) signifies any unique delimiting character that does not 
appear in the string. 

string specifies the group of characters to be checked for. If 
string is not specified, only the current line is deleted. 

1. The zone set by the ZONE subcommand or the default zone setting is 
checked for the presence of the character string. A character 
string with a length greater than the current zone setting causes 
the error message ZONE ERROR. 

Responses 

If the character string is not found by the end of the file, no 
deletions occur, the current line pointer is unchanged, and the message 

STRING NOT FOUND,, NO DELETIONS MADE 

is displayed. 

MsJ2i§Z Mode Considerations 

When the DSTRING subcommand is issued at a display terminal in display 
mode, if verification is on, the screen is changed to reflect the 
deletions from the file. 
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FILE 

Use the FILE subcomnand to write the edited file on disk and, 
optionally, override the file identifier originally supplied in the EDIT 
command. The format of the FILE subcommand is: 

| FILE | [fn [ft [fm]]] I 

where : 

fn indicates the filename for the file. If filename is omitted, 
filetype and filemode cannot be specified, and the existing 
filename, filetype, and filemode are used. 

ft indicates the filetype for the file. 

fm indicates the filemode for the file. 

Usage Notes 

1. When you specify a file identifier, any existing file that has an 
identical fileid is replaced. If the file being edited had been 
previously written to disk, that copy of the file is not altered. 

2. You can change the filename and filemode during the editing session 
using the FNAME and FMODE subcommands. 

Responses 

The CMS Ready message indicates that the file has been written to disk 
and control is returned to the CMS environment. 



FIND 

Use the FIND subcommand to locate a line based on its initial character 
string. The format of the FIND subcommand is: 

i • 

| Find | [line] 

i 

w her e : 

line is any character string, including blanks and tabs, that you 
expect to find beginning in column 1 of an input record. If line 
is not specified, the current line pointer is moved down one 
line. 

Usage Notes 

1. Only one blank can be used as a delimiter following the FIND 
subcommand; additional blanks are considered part of the character 
string. 

2. If the image setting is ON, the editor expands tab characters to 
the appropriate number of blanks before searching for the line. 
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3. If the current line pointer is at the bottom of the file when the 
FIND subcommand is issued the search begins at the top of the 
file. 

Responses 

When verification is on, the line is displayed at the terminal. If the 
line is not found, the message 

EOF: 

is displayed and you may use the REUSE (=) subcommand to search again, 
beginning at the top of the file. 



FMODE 

Use the FMODE subcommand to display or change the filemode of a file. 
The format of the FMODE subcommand is: 



| FMode | [fm] 



w h er e : 

fm indicates the filemode that is to replace the current filemode 
setting. You can specify only a filemode letter (A-G, S, Y, or Z) , 
or a filemode letter and number (0-5) . If you specify a filemode 
letter, the existing filemode number is retained. 

Hsjage Notes 

1. The specified filemode is used the next time a FILE, SAVE, or 
automatic save request is issued. If the file being edited had 
been previously filed or saved, that copy of the file remains 
unchanged. 

2. If the disk specified by filemode already contains a file with the 
same filename and filetype, that file is replaced when a FILE, 
SAVE, or automatic save request is issued; no warning message is 
issued. 

3. If the filemode specified is that of a read-only disk, then when an 
attempt is made to file or save the file, the editor displays an 
error message. 

J£6§E2Uses 

If you enter the FMODE subcommand without specifying fm, the editor 
displays the current filemode. 

Display Mode Considerations 

When you specify a new filemode with the FMODE subcommand, the editor 
writes the new filemode in the filemode field at the top of the screen. 
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FNAME 

Use the FNAME subcommand to display or change the filename of a file. 
The format of the FNAME subcommand is: 

| FName | [ f n ] I 

where : 

fn indicates the filename that is to replace the current filename. 

1. The specified filename is used the next time a FILE, SAVE, or 
automatic save request is issued. If the file being edited had 
been previously filed or saved, that copy of the file remains 
unchanged. 

2. If a file already exists with the specified filename and the same 
filetype and filemode, that file is replaced; no warning message is 
issued. 

3. You can use the FNAME subcommand when you want to make multiple 
copies of a file, with different filenames, without terminating 
your edit session. 

Responses 

If you enter the FNAME subcommand without specifying fn, the editor 
displays the current filename. 

Pi§£lilX Mode Considerations 

When you issue the FNAME subcommand specifying a new filename, the 
editor writes the new name in the filename field at the top of the 
screen. 



FORMAT (3270 only) 

Use the FORMAT subcommand to change the mode of a local or remote 3270 
terminal from display to line (or line to display) mode. The format of 
the FORMAT subcommand is: 

| FOEMat | /DISPLAY) I 

I I (LINE / I 

where : 

DISPLAY specifies that a full screen display of data is to occur. 
Subcommands do not appear as part of the data displayed. 
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LINE specifies that the display station is to operate as a 
typewriter terminal. Every line you enter is displayed on the 
screen; the screen looks like a typewriter terminals console 
sheet. 

M^ajge Notes 

1. Line mode is the default for remote 3270s. If you are using a 
remote 3270 in display mode, and you enter the INPUT subcommand, 
you are placed in line mode while you enter input. When you return 
to edit mode, the full screen display is restored. 

2. If you used the NODISP option of the EDIT command to invoke the 
editor, the FORMAT subcommand is treated as an invalid subcommand, 
as it is on typewriter terminals. 

3. The column settings for the VERIFY, TRUNC, and ZONE subcommands 
remain unchanged when you issue the FORMAT subcommand. 

Responses 
None. 



FORWARD (Primarily 3270) 

Use the FORWARD subcommand to move the current line pointer towards the 
end of the file you are editing. The format of the FORWARD subcommand 
is: 




where :: 

n is the number of records you wish to move forward in the file being 
edited. If n is not specified, 1 is assumed. 

1. The FORWARD subcommand is eguivalent to the DOWN and NEXT 
subcommands; it is provided for the convenience of 3270 users. 

J*©sponses 

When verification is on, the new current line is displayed. If the 
number specified exceeds the number of lines remaining in the file, the 
current line pointer is positioned at EOF:. 
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GETFILE 

Use the GETFILE subcommand to insert all or part of a specific CMS file 
into a file that you are editing. The format of the GETFILE subcommand 
is: 



r - 



i I r r r r mi 1 

| | Getfile | fn |ft |fm |firstrec |numrec|||| I 

II I I I II II I II I I 

I I L L L L JJJJ I 



where: 

fn is the filename of the file that contains the data to be 
inserted into the file you are editing. 

| ft is the filetype of the file that contains the data to be 
| inserted. If ft is not specified, the filetype of the file you 

I are editing is assumed. 

I fm is the filemode of the file that contains the data to be 
I inserted. If fm is not specified, all of your accessed disks 

| are searched for the file. 

firstrec indicates the record number of the first record you want to 
copy. 

numrec indicates the number of lines to be inserted, starting with 
the line specified by firstrec. If numrec is not specified, 
or specified as *, then the remainder of the file between 
firstrec and the end of the file is inserted. 

Usage Notes 

1. The GETFILE operand list is positional; if you omit one operand, 
you cannot specify any operands that follow. Thus, if you want to 
specify firstrec and lastrec, you must specify the filetype and 
filemode of the file. 

2. The last line inserted becomes the new current line. 

3. If the record length of the records in the file containing the data 
to be inserted exceeds that of the file being edited, an error 
message is displayed, and the GETFILE is not executed; if shorter, 
the records are padded to the record length of the file being 
edited and inserted in the file. 

4. If you use the GETFILE subcommand to insert lines into a VSBASIC 
file, you must also use the RENUM subcommand to reseguence the 
file. 

5. If the editor fills up available storage while executing a GETFILE 
reguest, it may not be able to copy all of the file. You should 
determine how many records were actually copied, and then write the 
current file on disk. 
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5§s£ODses 

When verification is on, the last line inserted into the file is 
displayed. If the end of the file has been reached the message 

EOF REACHED 

is displayed, followed by the display of the last line inserted. 



IMAGE 

Use the IMAGE subcommand to control how the editor should handle 
backspaces and tab characters or to display the current image setting. 
The format of the IMAGE subcommand is: 



| IMAGE 




1 
1 
I 
1 
1 


r t 

ION | 
|OFF | 
| CANON | 

L J 


whe re : 
ON 


si 


>ecif 


ies that any te 



specifies that any text entered while in input mode or as a line 
of data following a FIND, INPUT, OVERLAY, or REPLACE subcommand, 
is expanded into a line image; backspaces are removed and tabs 
are replaced by blanks. 

Text entered in the form of delimited strings, as in CHANGE, 
LOCATE, and ALTER, is not expanded; tabs and backspaces are 
treated in the same way as other characters. 

IMAGE ON is the default for all filetypes except SCRIPT. 

OFF specifies that tabs and backspaces are treated as data 
characters in the same way as other characters. They are not 
deleted, translated, expanded, or reordered. 

CANON specifies that backspaces may be used to produce compound 
characters such as underscored words, headings, or phrases. 
Before they are inserted in the file, compound characters are 
ordered, with backspaces arranged singly between the characters 
that overlay each other; the overlaying characters are arranged 
according to their EBCDIC values. Tab characters are handled as 
for IMAGE OFF. 

CANON is the default for SCRIPT files. 

Usa^e. Notes 

1. When the image setting is ON, tab characters are expanded to an 
appropriate number of blanks, according to the current settings of 
the TABSET subcommand. The TABSET command has no effect if the 
image setting is either off or canon. 
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2. When the image setting is on, backspaces are handled as follows: 

• Backspace characters act in a similar manner to the logical 
character delete symbol, in deleting the previous characters if 
a sufficient number of other characters or blanks follow the 
backspace characters. However, backspace characters that 
immediately follow a command name are interpreted as separator 
characters and do not delete any part of the command name. 

• If a backspace character is the last character in the input 
line, it is ignored. 

Responses 

When you issue the IMAGE subcommand with no operand, the current IMAGE 
setting is displayed. 



INPUT 

Use the INPUT subcommand to insert a single line into a file, or, if no 
data line is specified, to leave edit mode and enter input mode. The 
format of the INPUT subcommand is: 

| Input | [line] 

L. 



w h er e : 

line specifies the input line to be entered into the file. It can 

contain blanks and tabs; if you enter at least two blanks 

following the INPUT subcommand and no additional text, a blank 
line is inserted into the file. 

Usage Notes 

1. Each line that is inserted into the file becomes the new current 
line. 

2. When you are using line-number editing (LINEMODE LEFT or LINEMODE 
RIGHT) you cannot use the INPUT subcommand to insert a single line 
of data; use the nnnnn subcommand. 

Responses 

When you issue the INPUT subcommand with two operands, and verification 
is on, the editor displays: 

INPUT: 

All subseguent lines you entered are written into the file, until you 
enter a null line to return to edit mode. 
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fiisEljil Mode Considerations 

1 . When you insert lines when using a local display terminal in 
display mode, the editor writes each record on line 9. The old 
current line and all records above it move up one line, except for 
the topmost record formerly on line 2, which is deleted from the 
screen. 

2. If you are using a remote display terminal in display mode and you 
issue the INPUT subcommand with no text, the terminal is forced 
into line mode. The display of the file on the screen disappears 
and the word INPUT: appears. As you enter input lines, they appear 
in the output display area, when you leave input mode by entering 
a null line, the remote terminal returns to display mode. The 
display of the file reappears on the screen, with the lines you 
have just entered in their proper place in the file. 

3. When you are entering data in input mode at a display terminal that 
is in line mode, a tab character generated by a program function 
(PF) key only generates one character, and appears as one character 
on the screen. That is, the line does not appear spaced according 
to the tab settings. 



LINEMODE 

Use the LINEMODE subcommand to set, cancel, or display the status of 
line-number editing. When you use line-number editing, you can input, 
locate, and replace lines by referencing their record numbers. 
Line-number editing is the default for VSBASIC and FREEFORT files. The 
format of the LINEMODE subcommand is: 



r i 

1 | LINEmode | |LEFT | 
|RIGHT| 
I I I IOFF | 

L J 



w her e : 

LEFT initializes line-number editing and places seguences numbers 

L on the left, in columns 1 through 5, right justified and blank 

padded; the near zone is set to 7. If the filetype is FREEFORT, 

columns 1 through 8 are used for serial numbers; the near zone is 

set to 9. 

You should never use left— handed line-number editing for files in 
which data must occupy columns 1 through 6, for example ASSEMBLE 
files. 

RIGHT initializes line— number editing and places seguence numbers 

R on the right, in columns 76 to 80, right justified and zero 

padded. The end zone and truncation columns are set to 72. 

This operand is valid only for files with fixed-length 
80-character records. 
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OFF cancels line-number editing and (if you were using left-handed 
line-number editing)) resets the first logical tab setting to 
column 1. The VERIFY, TRUNC, and ZONE subcommand settings remain 
unchanged. Serialization may still be in effect. OFF is the 
default for all filetypes except VSBASIC and FREEFORT. 

Usa^e Notes 

1. When you enter input mode while you are using line-number editing, 
you are prompted with a line number to enter each line. The 
default prompting increment is 10; you may change it using the 
PROMPT subcommand. 

2. When you are prompted on a typewriter terminal, enter your input 
line on the same line as the prompted line number. If you are 
using right-handed line-number editing, on a typewriter terminal or 
on a display terminal in line mode, the serial numbers are not 
redisplayed in columns 76 to 80 (unless you use the VERIFY 
subcommand to increase the verification setting) . When a line is 
displayed in edit mode, the line numbers always appear on the left, 
even though they are on the right in the disk copy of the file. 
Whether or not the line numbers are displayed on the right depends 
on the current verification setting. 

3. You cannot use the INPUT or REPLACE subcommands to input a single 
data line when you are using line-number editing; use the nnnnn 
subcommand instead. 

4. When you initialize line-number editing for files that already 
exist, the editor assumes that the records are in the proper format 
and numbered in ascending order. 

5. If you want to place serial numbers in columns 76 through 80, but 
you do not wish to use line-number editing, use the SERIAL 
subcommand. 

Responses 

When you issue the LINEMODE subcommand with no operands, the current 
setting is displayed. 

Display Mode Considerations 

When you use line-number editing on a display terminal in display mode, 
the prompting numbers in input mode appear on line 2 of the display 
screen, in the editor message area. Enter your input lines in the user 
input area. Regardless of whether you are using right- or left-handed 
line-number editing, the line numbers always appear in their true 
position in the file. 
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LOCATE 

Use the LOCATE subcommand to scan the file beginning with the next line 
for the first occurrence of a specified character string. The format of 
the LOCATE subcommand is: 



r- 

|[ Locate] | /[string[/]] 

i 



where : 

/ (diagonal) signifies any unique delimiting character that does not 
appear in the string. The delimiter may be any nonblank 
character. The closing delimiter is optional. 

string specifies any group of characters to be searched for in 
the file. 

Usage Notes 

1 . If the beginning delimiter is /, you can omit the subcommand name 
LOCATE. If you enter only 

/ 
on a line, the current line pointer is moved down one line. 

2. If string is null or blank, the search is successful on the first 
line encountered. If the line pointer is at the end of the file 
when the LOCATE subcommand is issued, scanning starts from the top 
of the file. 

3. Use the ZONE subcommand when you want the Editor to search only a 
specific column. If you specify a character string longer than the 
current zone width, the Editor issues the message ZONE ERROR. 

Responses 

When verification is on, the line containing the specified string is 
displayed. If the string is not found, the messages 

NOT FOUND 
EOF: 

are displayed, and you may use the REUSE (=) subcommand to request that 
command be repeated, beginning at the top of the file. 



LONG 

Use the LONG subcommand to cancel a previous SHORT subcommand request, 
The format of the LONG subcommand is: 



| LONG 
i 
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Usac[e Notes 

1 . When the LONG subcommand is in effect (it is the default) , the 
Editor responds to invalid subcommands with the message 

?EDIT: line ... 

Responses 
None. 



NEXT 

Use the NEXT subcommand to advance the line pointer a specified number 

of lines towards the end of the file. The line pointed to becomes the 

new current line. The format of the NEXT subcommand is: 

I I r -i I 

| Next I In | I 

I I 111 I 



where : 

n indicates the number of lines to move the line pointer. If n is 
omitted, then the pointer is moved down only one line. 

Usa<je Notes 
1. NEXT is equivalent to DOWN and FORWARD. 

Responses 

When verification is on, the new current line is displayed. If the end 
of the file is reached, the message 

EOF: 

is displayed. 
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OVERLAY 

Use the OVERLAY subcommand to selectively replace one or more character 
strings in the current line with the corresponding nonblank characters 
in the line being keyed in. The format of the OVERLAY subcommand is: 



( 

| Overlay | [line] 



where : 

line specifies an input line that replaces corresponding character 
positions in the current line. On a typewriter terminal, if you 
enter the OVERLAY subcommand with no data line, the input record 
remains unchanged. 

H.sac[e Notes 

1. Blank characters in the input line indicate that the corresponding 
characters in the current line are not to be overlaid. For example 

CHARMIE 
o L 
CHARLIE 

Blanks in columns 3, 4, 5, and 6 of the OVERLAY line indicate that 
columns 1,2, 3 and 4 or the current line are not to be changed. 
(At least one blank must follow the OVERLAY subcommand, which can 
be truncated as 0) . 

2. This subcommand may be entered at a typewriter terminal by typing 
the letter "o", followed by a backspace, followed by the overlaying 
characters. This sets up the correct alignment on the terminal. 

3. An underscore in the overlaying line must be used to place a blank 
into the corresponding position of the current line. Thus, an 
underscore cannot be placed (or replaced) in a line 

OVERLAY should be used with care on lines containing underscored 
words or other compound characters. 

4. To perform a global overlay operation, issue the REPEAT subcommand 
just prior to issuing the OVERLAY subcommand. For example, when 
you enter 

repeat * 
overlay * 

an asterisk is placed in the left-most column of each record in the 
file, beginning with the current line. The left-most column, for 
files with the IMAGE setting ON, is determined by the first logical 
tab setting. 

Responses 

When verification is on, the line is displayed at the terminal after it 
has been overlaid. 



240 IBM VM/370: CMS Command and Macro Reference 



EDIT Subcommands-OVERLAY, PRESERVE, PROMPT 

Pi§P.lilY. Mode Considerations 

In addition to using the OVERLAY subcommand in the normal way, you may 
also issue the OVERLAY subcommand with no operands. The next line you 
enter is treated as overlay data. To cancel the overlay request, press 
the Erase Input key and then the Enter key. 



PRESERVE 

Use the PRESERVE subcommand to save the settings of various EDIT 
subcommands until a subsequent RESTORE subcommand is issued. The format 
of the PRESERVE subcommand is: 

i 

I PREserve 
i 



H§aqe Notes 
1 . Settings are saved for the following subcommands: 



CASE 


LONG 


TABSET 


FMODE 


RECFM 


TRUNC 


FNAME 


SERIAL 


VERIFY 


IMAGE 


SHORT 


ZONE 


LINEMODE 






Responses 






None. 







PROMPT 

Use the PROMPT subcommand to change the prompting increment for input 
line numbers when you are using line-number editing. The format of the 
PROMPT subcommand is: 



I r -i I 

PROMPT I In | | 

I I10 I I 

I L J I 



where : 

n specifies the prompting increment; the default value is 10. The 
value of n should not exceed 32,767. 

Resp.on.ses 

When you issue the PROMPT subcommand with no operands, the current 
setting is displayed. 
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QUIT 



Use the QUIT subcommand to terminate the current editing session and 
leave the previous copy of the file, if any, intact on the disk. The 
format of the QUIT subcommand is: 



QUIT 



Usage Notes 
1 



2. 



You can use the QUIT subcommand when you have made a global change 
that introduced errors into your file; or whenever you discover 
that you have made errors in editing a file and want to cancel your 
editing session. 

If a SAVE subcommand or automatic save request has been issued, the 
file remains as it was when last written. 

The QUIT subcommand is a convenient way to terminate an edit 
session when you enter an incorrect filename on the EDIT command 
line, or when you edit a file merely to examine, but not to change, 
its contents. 



The CMS Beady message indicates that control has been returned to CMS. 

RECFM 

Use the RECFM subcommand to indicate to the editor whether the record 
format of the file is fixed-length or variable-length, or to display the 
current RECFM setting. The format of the RECFM subcommand is: 



RECfm 



I r t 
I |F| 
I I V | 
I L J 



w her e : 

F indicates fixed-length records. 

V indicates variable-length records. 

Usage Notes 

1. V is assumed by default for all new LISTING, FREEFORT, VSBDATA, and 
SCRIPT files. V is also recommended for EXEC files. Usually, a 
variable-format file occupies a smaller amount of disk space 
because trailing blanks are deleted from each line before it is 
written onto disk. 

2. When you use the RECFM subcommand to change the format of a file 
from fixed-length to variable-length records, trailing blanks are 
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removed when the file is written to disk; when you are changing 
variable-length records to fixed-length, all records are padded to 
the record length. 

Responses 

When you use the RECFM subcommand without specifying F or V r the current 
setting is displayed. 

Display Mode Considerations 

When you specify a new record format with the RECFM subcommand, the 
editor writes the new record format in the format field at the top of 
the screen. 



RENUM 

Use the RENUM subcommand to recompute the line numbers for VSBASIC and 
FREEFORT source files. The format of the RENUM subcommand is: 



I I r r -n I 

I RENum | Istrtno |incrno|| I 

I I I 10 I str tno | | I 

I | l * L JJ | 

where : 

strtno indicates the number from which you wish to start renumbering 
your file. Because RENUM renumbers the whole file from 
beginning to end, the number you specify as strtno becomes the 
statement number of the first statement in the newly 
renumbered file. This number may not exceed 99999 for VSBASIC 
files or 99999999 for FREEFORT files. The default start 
number value is 10 and the specified start number must not be 
zero. 

incrno indicates the increment number value by which you wish to 
renumber your file. This value may not exceed 99999 for 
VSBASIC files or 99999999 for FREEFORT files. The default for 
incrno is strtno, the first sequence number in the renumbered 
file, and the specified incrno must not be zero. 

Usa^e Notes 

1. If you do not specify strtno and incrno, the default value for both 
is 10. If you specify only strtno, incrno defaults to the same 
value as strtno. 

2. All VSBASIC statements that use statement numbers for operands are 
updated to reflect the new line numbers. The VSBASIC statements 
with line number operands are: 



DELETE 


IF 


READFILE 


EXIT 


INPUT 


REREADFILE 


GET 


PRINT USING 


REHRITEFILE 


GOSUB 


PUT 


WRITEFILE 


GOTO 
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3. The current line pointer remains as it was before you entered the 
RENOM subcommand regardless of whether or not RENUM completes 
successfully. If you are editing a VSBASIC file, the file to be 
renumbered must either originate from a read/write disk or you must 
issue an FMODE subcommand to change the file destination to a 
read/write disk. 

4. If any error occurs during the RENUM operation, the editor 
terminates the RENUM operation and the file being edited remains 
unchanged. 

Responses 

When verification is on, the message EDIT: indicates that the RENUM 
subcommand completed processing. 



REPEAT 

Use the REPEAT subcommand to execute the immediately following OVERLAY 
subcommand (or an X or Y subcommand assigned to invoke OVERLAY) for the 
specified number of lines, or to the end of the file. The format of the 
REPEAT subcommand is: 



r- 
I 

1 REPEAT 

I 
! 



where: 



r t 

|n| 
1*1 
111 

L J 



n indicates the number of times to repeat the OVERLAY request that 
immediately follows, beginning with the current line. An asterisk 
(*) indicates that the request is to be repeated until the end of 
the file is reached. If neither n nor * is specified, then only 
one line is handled. The last line processed becomes the new 
current line. 

Usage Notes 

1. If the next subcommand issued after the REPEAT subcommand is not an 
OVERLAY subcommand, the REPEAT subcommand is ignored. 

2. For an example of a REPEAT subcommand followed by an OVERLAY 
subcommand, see the discussion of the OVERLAY subcommand. 

Responses 
None,, 
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REPLACE 

Use the REPLACE subcommand to replace the current line with a specified 
line or to delete the current line and enter input mode. The format of 
the REPLACE subcommand is: 

I [line] 

where : 

line specifies an input line that is to replace the current line. If a 
line is specified, then the editor puts it into the file in place 
of the current line. If no line is specified, the editor deletes 
the current line and enters input mode. 

H§§3® Notes 

1. If the LINEMODE option is set to LEFT or RIGHT, then issuing the 
REPLACE subcommand specifying a line is not valid. If the REPLACE 
subcommand is used without any operands when LINEMODE is set to 
LEFT or RIGHT, you are prompted for the next available line number; 
the first data line you enter replaces the current line number. 

2. If you use the REPLACE subcommand with no operands to enter input 
mode, and the next line you enter is a null line, then the current 
line is not deleted, and you are returned to edit mode. 

Responses 

When verification is on, and you issue the REPLACE subcommand with no 
data line, the message 

INPUT: 

indicates that your virtual machine is in input mode. 



RESTORE 

Use the RESTORE subcommand to restore the settings of EDIT subcommands 
to their values when the PRESERVE subcommand was last issued, or to 
their default values if a PRESERVE subcommand has not been issued. The 
format of the RESTORE subcommand is: 

r- 

| REStore 



Osage Notes 
1. The settings are restored for the following subcommands: 



CASE 


LONG 


TABSET 


FMODE 


RECFM 


TRUNC 


FNAHE 


SERIAL 


VERIFY 


IMAGE 


SHORT 


ZONE 


LINEMODE 
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Responses 
None. 



RETURN 

Use the RETURN command to return to edit mode from the CMS subset 
environment. RETURN is not an EDIT subcommand, but is listed here as a 
companion to the CMS subcommand. The format of the RETURN command is: 

r - 

| RETURN 



l§S£Oiises 

When verification is on, the editor responds 

EDIT : 
to indicate that your virtual machine is in edit mode. 



REUSE (=) 

Use the REUSE subcommand (which can also be specified as =) to stack 
last in, first out (LIFO) the last EDIT request, except for REUSE or a 
question mark, and then execute the stacked subcommands. The format of 
the REUSE (or =) subcommand is: 



I [subcommand] I 

W= J I 

i 



f REUSE) 



w her e : 

subcommand specifies any valid EDIT subcommand. 

Usacje Notes 

1. If the subcommand you enter on the REUSE subcommand line is an 
invalid subcommand, the editor clears the stack. 

2. You can use the REUSE subcommand to repeat a subcommand request 
that was not satisfied the first time, for example, a LOCATE 
subcommand that resulted in an end— of— file condition. If you enter 



the LOCATE subcommand is stacked, then read by the editor and 
executed again. This time the search begins from the top of the 
file. 

3. You can also enter more than one = on a single line, to stack the 
last issued subcommand more than once. For example: 
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locate /xyz/ 

XYZ IS MY FAVORITE 

I FIRST MET XYZ 
XYZ«S NAME IS DERIVED 
LAST SAW XYZ 
EOF: 

the LOCATE subcommand is stacked four times, and then the editor, 
reading from the stack, executes the four stacked subcommands. 

You can do the following, if you issue a CHANGE subcommand before 
positioning your current line pointer: 

c/xx/yy 

NOT FOUND 
= 1/x/ 
LINE XXXX 
LINE YYXX 

in this example, the CHANGE request was issued and stringl was not 
found. The REUSE subcommand stacks the CHANGE subcommand and 
stacks a LOCATE subcommand in front of it then, the LOCATE 
subcommand is read and executed, followed by the CHANGE 
subcommand. 

You can stack an INPUT or REPLACE subcommand in front of a data 
line you mistakenly entered in edit mode, for example: 

roses are red, violets are blue 

?EDIT: ROSES ARE RED, VIOLETS ARE BLUE 

= input 

INPUT: 

without cms 

i would be, too. 

the = subcommands stacks the INPUT subcommand in front of the data 
line. Reading from the stack, the editor executes the INPUT 
subcommand, then reads in, as the first line of data, the line 
beginning with ROSES. The file contains 

ROSES ARE RED, VIOLETS ARE BLUE 

WITHOUT CMS 

I WOULD BE, TOO. 



Responses 

Responses are those that are issued to the stacked subcommands. 
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SAVE 

Use the SAVE subcommand to write on disk the file that is currently 
being edited, without returning control to CMS, and optionally to change 
the file identifier. The format of the SAVE subcommand is: 

| SAVE | [fn [ft [fm ]]] I 

wh er e : 

fn indicates the filename of the file to be saved. If you specify 
only fn, then the filetype and filemode are the same. 

ft indicates the filetype of the file to be saved. 

fm indicates the filemode of the file to be saved. 

1. If you specify a new file identifier, any existing file with same 
file identifier is replaced; no warning message is issued. The 
file being edited, if previously written to disk, is not altered. 

2. To write a file on disk and terminate the editing session, use the 
FILE subcommand, 

3. If you want to save the contents of a file at regular intervals, 
use the AUTOSAVE subcommand. 

Responses 

When verification is on, the editor displays 

EDIT: 

to indicate the SAVE request completed successfully and you may continue 
to enter EDIT subcommands. 



SCROLL/SCROLLUP (3270 only) 

Use the SCROLL and SCROLLUP subcommands to scan the contents of a file 
on a display screen. 

SCROLL causes the editor to scan forward through the file; SCROLLUP 
causes the editor to scan backward through the file. The format of the 
SCROLL and SCROLLUP subcommands is: 



i 

| | (scroll } 
I | \S[croll]U[p]/ 
I I 
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where: 



n is a number from 1 to 255 that specifies the number of successive 
screens of data to be displayed. If an asterisk (*) is specified, 
the entire file, from the current line to the end or beginning of 
the file, is displayed. If n is not specified, 1 is the default. 

H§^3§ Notes 

1. The SCROLLUP subcommand can be specified by any combination of the 
truncation of SCROLL and UP; the minimum truncation is SU. 

2. The number of lines shifted forward or backward depends on the 
current verification setting. If the verification setting is 80 
characters or less, then a scroll request displays a file in 
increments of 20 lines. If the verification setting is more than 
80 characters, than a scroll request displays a file in increments 
of 10 lines. 

A single SCROLL subcommand, therefore, is the equivalent of DOWN 20 
or DOWN 10, depending on the record length, and SCROLLUP is the 
equivalent of UP 20 or UP 10. 

3. When you use the SCROLL or SCROLLUP subcommands to display more 
than one screenful, each display is held for one minute, and the 
screen status area indicates MORE... . To hold the screen display 
longer, press the Enter key. 

To halt scrolling before all the requested screenfuls are 
displayed, enter the HT immediate command and press the Cancel key 
twice. 

4. When you begin scrolling from the top of the file, the first 
screenful contains only the first seven lines. When you scroll to 
the end of the file, the last screen may duplicate lines displayed 
in the previous screen. 

Responses 

The screen display is shifted forward or backward. 

SERIAL 

Use the SERIAL subcommand to control the serialization of records in 
columns 73 through 80. The format of the SERIAL subcommand is: 




OFF 

r t 
ON |incr | 
ALL Q0 | 
seq L J 



j 



where : 

OFF indicates that neither serialization numbers nor identifiers are 
to be placed in columns 73-80. 
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ON indicates that the first 3 characters of the filename are to be 
used in columns 73-75 as an identifier. 

ALL indicates that columns 73-80 are to be used for serialization 
numbers. 

seq specifies a 3-character identification to be used in columns 
73-75. 

incr specifies the increment for the line number in columns 76-80 (or 
73-80) . This number also becomes the first line number. If incr 
is not specified, then 10 is assumed. 

Usage ^2t§§ 

1. The SERIAL subcommand is valid only for files with fixed-length, 80 
character records. To renumber VSBASIC or FREEFORT files, use the 
RENUM subcommand. 

2. The serialization setting is ON, by default, for the following 
filetypes : 

ASSEMBLE PLI 

COBOL PLIOPT 

DIRECT UPDATE 

FORTRAN UPDTxxxx 
MACRO 

3. When serialization is in effect, records in a file are reseguenced 
each time a FILE, SAVE, or automatic save reguest is issued. If 
you are using line-number editing, you must issue the subcommand 

linemode off 

before issuing a FILE or SAVE subcommand if you wish the records to 
be reseguenced. 

Res£oases 

If you issue the SERIAL subcommand in a file with a zone column greater 
than 72, the message 

END ZONE SET TO 72 

is displayed, to indicate that the zone has been changed. If the zone 
column is 72 or less, but the truncation column is greater than 72, the 
message 

TRUNC SET TO 72 

is displayed. 
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SHORT 



Use the SHORT subcommand to request the editor to respond to invalid 
subcommand lines with the short form of the ?EDIT message. The format 
of the SHORT subcommand is: 



| SHORT 

i 



I 



Osacje Notes 
1. When the SHORT subcommand is in effect, the editor responds 

to an invalid subcommand line, and 



to an invalid macro request. 

2. To resume displaying the long form of the ?EDIT message, use the 
LONG subcommand. 



Responses 
None. 



STACK 



Use the STACK subcommand to stack data lines or EDIT subcommands in the 
console stack for subsequent reading. The format of the STACK 
subcommand is: 




where : 
n 



indicates the number of lines to be stacked beginning with 
the current line. If a number or a subcommand is not 
specified, then one line is assumed by default. A maximum 
of 25 lines can be stacked. 



subcommand specifies an EDIT subcommand to be stacked. 
stacks a null line. 
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Usage Notes 

1. STACK subcommands are used in writing edit macros, to stack lines 
from a file so that they can be moved around, or to stack 
additional subcommands. 

2. All lines stacked with the STACK subcommand are stacked FIFO (first 
in, first out) . 

3. The length of stacked lines is determined by the current TRUNC 
setting. 

Responses 

None. If you issue the STACK subcommand to stack an EDIT subcommand 
line, the stacked subcommand is executed immediately; responses are 
those to the stacked subcommands, if any. 



TABSET 

Use the TABSET subcommand to set logical tab stops for a file. The 
format of the TABSET subcommand is: 



I 
i 




where: 

| n1 [n2... nn] indicates column positions for logical tab settings. You 
may specify up to 25 numbers, separated from each other 
by at least one blank. n1 indicates the first column in 
the file that may contain data. 

1. The editor assigns the following tab settings by default: 

File types Default Tab Settings 

ASM3705, ASSEMBLE, 1,~10, 16, 31, 36, 41, 46, 69, 72, 80 

MACRO, UPDATE, 

UPDTxxxx 

| AMSERV 2, 6, 11, 16, 21, 26, 31, 36, 41, 46, 51, 

I 61, 71, 80 

FORTRAN 1, 7, 10, 15, 20, 25, 30, 80 

FREEFORT 9, 15, 18, 23, 28, 33, 38, 81 

BASIC, VSBASIC 7, 10, 15, 20, 25, 30, 80 

PLIOPT, PLI 2, 4, 7, 10, 13, 16, 19, 22, 25, 31, 37, 

43, 49, 55, 79, 80 

COBOL 1, 8, 12, 20, 28, 36, 44, 68, 72, 80 

Others 1, 6, 11, 16, 21, 26, 31, 36, 41, 46, 51, 

61, 71, 81, 91, 101, 111, 121, 131 
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2. Tab settings have no effect if the IMAGE setting is either OFF or 
CANON. (CANON is the default for SCRIPT filetypes) . A tab entered 
into a file under these conditions appears as X'05 1 . 

| 3. The margins set by the TABSET subcommand are used by the INPUT, 
| REPLACE, OVERLAY, and FIND subcommands. 

Responses 
None. 



TOP 

Use the TOP subcommand to move the line pointer to the top of the file. 
The null top line becomes the current line. The format of the TOP 
subcommand is: 

| TOP | | 



Responses 

When verification is on, the message 

TOF: 
is displayed. 

Display Mode Considerations 

When you are using a display terminal, if you specify TOP and 
verification is on, line 9 contains the characters TOP (indicating the 
top of the file), lines 2 through 8 are blank, and lines 10 through 21 
contain the first 12 lines of the file. 



TRUNC 

Use the TRUNC subcommand to change the truncation column of records or 
to display the current truncation column setting. The format of the 
TRUNC subcommand is: 

I I r n 

| TRUNC | |n | 

I I I* I 

I I L J 



where: 



indicates the column at which truncation is to occur. If n is 
specified as an asterisk (*) , the truncation column is set to the 
record length for the filetype. 



Section 3. EDIT Subcommands and Macros 253 



EDIT Subcommands-TRUNC, TYPE 

.Usage Notes 

1. The editor assigns the following truncation setting by default: 

Filetypes Truncation Column 
ASSEMBLE, MACRO, UPDATE, UPDTXXXX 71 

AMSERV, COBOL, DIRECT, FORTRAN, 

PLI, PLIOPT 72 

All Others Record Length 

2. The truncation value is used by the INPUT, REPLACE, STACK, and 
OVERLAY subcommands, and also, for display terminals in display 
mode, the CHANGE subcommand when it is used with no operands. 

3. If your virtual machine is in input mode and you enter a line that 
is longer than the current truncation setting, the message 

TRUNCATED 

is displayed along with a display of the truncated line. Your 
virtual machine is still in input mode. 

When you enter the TRUNC subcommand with no operands, the editor 
displays the current setting. 



TYPE 

Use the TYPE subcommand to display all or any part of a file at the 
terminal. The format of the TYPE subcommand is: 



where : 

m indicates the number of lines to be displayed, beginning with the 

current line. An asterisk (*) indicates all lines between the 
current line and the end of the file. If m is omitted, only one 
line is displayed. If the number of lines specified exceeds the 
number remaining in the file, displaying stops at the end of the 
file. 

n indicates the column at which displaying is to stop, overriding the 
current end column for verification. If n is specified as *, it 
indicates that displaying is to take place for the full record 
length. 

Usage Notes 

1. Use the TYPE subcommand to display lines when you are editing a 
file with verification off. 
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2. If you display one line, the current line pointer does not move; if 
you display more than one line, the current line is positioned at 
the last line displayed, or at the end of the file if you specified 
*. 

| 3. If you have set an end verification column to a value less than the 
| record length, and you want to display an entire record, enter 

| type 1 * 

| 4. If you do not specify an end column, the length of the line (s) 

| displayed is determined by the current end verification setting. 

| If you are using right-handed line-number editing, on a typewriter 

| terminal or a display terminal in line mode, the line numbers are 

| displayed on the left. 

Responses 

The reguested lines are displayed. 

Display Mode Considerations 

Since the TYPE subcommand was designed for printing terminals, it is of 
marginal value on a display terminal, except wheh you use line mode. 
However, if the display screen is interrupted by communication from the 
control program (CP) , you should use the TYPE subcommand to restore the 
full screen display. 



UP 

Use the UP subcommand to reposition the line pointer towards the 
beginning of the file. The format of the UP subcommand is: 



I r t 

Up I In | 

I II I 

I L J 



where: 



n indicates the number of lines the pointer is to be moved towards 
the beginning of the file. If a number is not specified, then the 
pointer is moved up only one line. The line pointed to becomes the 
new current line. 

Usage Notes 
1. UP is eguivalent to BACKWARD. 

Responses 

When verification is on, the line pointed to is displayed at your 
terminal. If the UP subcommand causes the current line pointer to move 
beyond the beginning of the file, the following message is displayed: 

TOF: 
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VERIFY 



Use the VERIFY subcommand to set or display the current verification 
setting. The format of the VERIFY subcommand is: 



I I r i rr t i 

I | Verify | |0N | ||startcol| endcol| 

I I I |OFF| || 1 1*1 

I I L J LL J J 



where: 



OM 



OFF 



specifies that lines that are located, altered, or changed are 
displayed, and changes between edit and input mode are 
indicated. ON is the default setting. 

specifies that lines that are located, altered, or changed are 
not displayed, and changes between edit and input mode are not 
indicated. 



startcol indicates the column in which verification is to begin, when 
verification is on. The default is column 1. startcol must 
not be greater than the record length or greater than endcol. 

endcol indicates the last column to be verified, when verification is 
on. endcol must not be greater than the record length. If 
endcol is specified as an asterisk, each record is displayed 
to the end of the record. 



Usage Notes 

1. If you issue the VERIFY subcommand with only one operand, that 
operand is assumed to be the endcol operand. For example, if you 
issue VERIFY 10, verification occurs in columns 1 through 10. 

2. The editor assigns the following settings, by default: 



Filetypes 

AMSERV, ASSEMBLE, COBOL, 
DIRECT, FORTRAN, MACRO, 
PLI, PLIOPT, UPDATE, UPDTXXXX 

Others (Including FREEFORT) 



Verification End Column 
Column 72 



Record Length 



Responses 

If you issue the VERIFY subcommand with no operands, the current 
startcol and endcol settings are displayed, regardless of whether 
verification is on or off. 
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XorY 



Use the X or Y subcommands to assign a given EDIT subcommand to be 
executed whenever X or Y is entered, or to execute the previously 
assigned subcommand a specified number of times. The format of the X 
and Y subcommands are: 




(subcommand | 
in I 

II I 



where: 



subcommand 



indicates any EDIT subcommand line. The editor assumes that 
you have specified a valid EDIT subcommand, and no error 
checking is done. 

indicates the number of times the previously assigned 
subcommand is to be executed. If X or Y is entered with no 
operands, 1 is assumed. 



U§§3® Notes 

1. Advancement of the current line pointer depends upon the EDIT 
subcommand that has been assigned to X or Y. If a number or a 
subcommand is not specified, the previously assigned subcommand is 
executed once. 

2. X and Y are initially set to null strings. If you enter X or Y 
without having previously assigned a subcommand to it, the editor 
issues the ?EDIT error message. 

3. You can use the X and Y subcommands in many instances where you 
must repeat a subcommand line many times while editing a file, but 
the situation does not lend itself to a global request. For 
example, if you assign X to a LOCATE and Y to a CHANGE subcommand, 
issue 



to execute the LOCATE request, and after examining the line, you 
can change it and continue searching, by entering the Y subcommand 
followed by the X subcommand, 

y#x 

or just continue searching: 

x 



Responses 

Responses are issued for the EDIT subcommands that are assigned to X and 
Y, in accordance with the current verification setting. 
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ZONE 



Use the ZONE subcommand to specify the columns of each record (starting 
position and ending position) to be scanned when the editor searches for 
a character string or to display the current ZONE settings. The format 
of the ZONE subcommand is: 




w her e : 

firstcol indicates the near zone column of each record to be scanned. 
If firstcol is specified as *, column 1 is assumed by 
default. 

lasted indicates the end zone column of each record to be scanned. 
If lasted is specified as *, the length of the record is 
assumed by default. 



n§ac[e Notes 
1 . The editor assigns the following settings by default: 



Filetyp.es Near_Zone 

ASSEMBLE, MACRO, UPDATE, Column~"T 

UPDTXXXX 

AMSERV, PLI, PLIOPT Column 2 

COBOL, DIRECT, FORTRAN Column 1 

BASIC, VSBASIC Column 7 

FREEFORT Column 9 

Others Column 1 



End__Zone 
Column 71 

Column 72 
Column 72 
Record Length 
Record Length 
Record Length 



2. The ZONE settings are used by the ALTER, CHANGE, and LOCATE 
subcommands to define the columns that will be scanned. If you 
specify a character string longer than the zone, you receive the 
message. 

ZONE ERROR 

and the subcommand is not executed. 

3. If you issue a CHANGE subcommand that increases the length of a 
line beyond the end zone setting, the line is truncated. 

4. You can use the ZONE subcommand to protect data in particular 
columns, for example. 
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edit newfile memo 

NEW FILE: 

EDIT: 

zone 

1 80 
zone 10 20 
input the zone is now set for columns 10-20 

EDIT: 

change /o/*/ 

the zone is n*w set for columns 10-20 

Note that the LOCATE and CHANGE subcommands operated on the word 
now, not the word zone, because scanning started in position 10, 
not in position 1 . 

Responses 

When you enter the ZONE subcommand without specifying zone settings, the 
editor displays the current setting. 



Use the ? subcommand to display the last EDIT subcommand executed except 
for a REUSE or ? (guestion mark) subcommand. The format of the ? 
subcommand is: 

r - 
I ? 



Usage Notes 

1. After an X, Y, or = subcommand, the last EDIT subcommand is the 
subcommand that was executed as a result of issuing the X or Y 
subcommand. 

Display Mode Considerations 

When you issue the ? subcommand using a 3270 in display mode, the last 
EDIT subcommand that was executed is redisplayed in the user input area. 
Press the Enter key to execute it again; you may modify the line before 
reentering it. 
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nnnnn 



Use the nnnnn subcommand to enter and locate lines when you are using 
line-number editing. The format of the nnnnn subcommand is: 



/nnnnn ) 
(nnnnnnnn J 



I [text] 



where : 

nnnnn indicates a line number between and 99999 if the filetype is 
BASIC or VSBASIC, or and 99999999 if the filetype is FREEFORT. 

text specifies a line of text to be inserted into the file at the 
specified line number. If a line with that number already 
exists, it is replaced. If no text line is specified, the 
current line pointer is positioned at the line number specified. 



Usatje Notes 

1. The nnnnn subcommand is valid only when you are using line— number 
editing, that is, you have issued the LINEMODE subcommand using the 
RIGHT or LEFT operand. Line— number editing is the default for 
VSBASIC and FREEFORT files. 

Responses 

When you issue the nnnnn subcommand with no operands, the line with the 
specified line number is displayed. If the line is not found, the 
editor displays the message 

LINE NOT FOUND 

and the current line pointer remains where it was when the nnnnn 
subcommand was issued. 
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EDIT Macros 

Edit macros are CMS EXEC files that execute sequences of EDIT 
subcommands. The following edit macros are supplied with VM/370 for 
your convenience. For additional information on creating and invoking 
your own edit macros and EXEC files, VM/370: CMS Oser^s Guide. 



$DUP 

Use the $DUP to duplicate the current line. The format of the $DOP 
macro is: 

i 

I I r -i 

| $DUP | |n | 

I I II I 

I I L J 



where : 

n indicates the number of times you want to duplicate the line; the 
maximum value you can specify is 25. If n is omitted, the current 
line is duplicated once. 

Usage Notes 

1. The last copy of the line duplicated becomes the new current line. 

2. If you use the logical line end symbol (#) to stack additional 
subcommands on the same line with the $DDP edit macro those 
subcommands are cleared from the console stack and the message 

STACKED LINES CLEARED BY $DUP 

is issued. The stacked subcommand (s) are not executed. 

Responses 

The last line duplicated (the new current line) is displayed. 



Section 3. EDIT Subcommands and Macros 261 



Edit Macros~$MOVE 
$MOVE 

Use the $MOVE edit macro to move one or more lines from one place in a 
file to another place. The format of the $MOVE macro is: 



| $HOVE | n (UP m 
| | <DOWN m 

I | (TO label 



where : 

n indicates the number of records you want to move, beginning 
with the current line. The maximum number of lines you can 
move is 25. 

UP m indicates that you want to move the lines toward the top of 
the file, in lines above the current line. 

DOWN m indicates that you want to move the lines toward the end of 
the file, in lines below the last line you are going to move. 

TO label indicates that you want the lines inserted following the 
specified label. The label must be all uppercase characters, 
and must start in column 1. 

Usage Notes 

1. The last line moved becomes the new current line. 

2. If the label is not found or if the DOWN value exceeds the number 
of lines remaining before end-of-file, the lines are inserted at 
the end of the file. If the UP value exceeds the number of lines 
remaining before the top-of-file, the lines are inserted at the top 
of the file. 

3. If you use the logical line end symbol (#) to stack additional 
subcommands on the same line with the $MOVE request, those 
subcommands are cleared from the console stack and the message 

STACKED LINES CLEARED BY $MOVE 

is displayed. The stacked subcommands are not executed. 

Responses 

When verification is on, the last line moved is displayed. 
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Section 4. DEBUG Subcommands 



This section describes the subcommands that are available to you when 
you use the debug environment to test and debug your programs. The 
debug environment is entered when: 

• The DEBUG command is issued from the CMS environment. (The DEBUG 
command is described in "Section 2. CMS Commands.") 

• An external interrupt occurs. (An external interrupt is caused by 
the CP EXTERNAL command.) 

• A breakpoint (instruction address stop) is encountered during program 
execution. (Breakpoints are set with the DEBUG subcommand BREAK.) 

When the debug environment is entered, the contents of all general 
registers, the channel status word (CSH) , and the channel address word 
(CAW) are saved so they may be examined and changed before being 
restored when leaving the debug environment. If debug is entered via an 
interrupt, the old program status word (PSW) for that interrupt is also 
saved. If DEBUG is the first command entered after an abnormal terminal 
(abend) occurs, the contents of all general registers, the CSW, the CAW, 
and the old PSW are available from the time of the abend. 

For hints on debugging your programs using the CMS debug environment, 
consult the VM^370: CMS User^s Guide. 



Section 4. DEBUG Subcommands 263 



DEBUG Subcommands-BREAK 



BREAK 



Use the BREAK subcommand to stop execution of a program or module at a 
specific instruction location, called a breakpoint. The format of the 
BREAK subcommand is: 




{ 



symbol) 
hexloc / 



is a decimal number, from to 15, which identifies the 
breakpoint., A maximum of 16 breakpoints may be in effect at 
one time; if you specify an id number that is already set for 
a breakpoint, the previous breakpoint is cleared and the new 
one is set. 

symbol is a name assigned to the storage location where the 
breakpoint is set. symbol, if used, must have been previously 
set using the DEFINE subcommand. 

hexloc is the hexadecimal storage location (relative to the current 
origin) where the breakpoint is to occur. hexloc must be on a 
halfword boundary and its value added to the current origin 
must not exceed your virtual machine size. 

linage Notes 

1. To set breakpoints before beginning program execution, enter the 
debug environment with the DEBUG command after you load the program 
into storage. After setting the breakpoints use the RETURN 
subcommand to leave the debug environment and issue the START 
command to begin program execution. 

load myprog 

debug 

break 1 20016 

break 2 20032 

return 

start 

2. When you assign hexloc to a breakpoint, you must know the current 
origin (set with the ORIGIN subcommand) . The hexloc you specify is 
added to the current origin to determine the breakpoint address. 

3. When a breakpoint is found during program execution, the message 

DMSDBG728I DEBUG ENTERED BREAKPOINT yy AT XXXXXX 

is displayed at the terminal. To resume program execution, use the 
GO subcommand. 

4. Breakpoints are cleared after they are encountered; thus if a 
breakpoint is encountered during a program loop you must reset the 
breakpoint if you want to interrupt execution the next time that 
address is encountered. 

5. When you set a breakpoint, the halfword at the address specified is 
replaced with B2Ex, where x represents the id number you assigned. 
After the breakpoint is encountered during execution, B2Ex is 
replaced with the original operation code. 
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6. You should set breakpoints only at valid operation code addresses; 
the BREAK subcommand does not check that the specified location 
contains a valid operation code. 

7. If you reference a virtual storage address that is in a shared 
segment, you are given a nonshared copy of the segment, and you 
receive the message 

i 

SYSTEM sysname REPLACED WITH NON-SHARED copy 

Responses 
None. 

CAW 

Use the CAW subcommand to display at the terminal the contents of the 
CAW (Channel Address Word) as it existed at the time the debug 
environment was entered. The format of the CAW subcommand is: 

CAW 



Usage Notes 

1. Issue the CAW subcommand to check that the command address field 
contains a valid CCW address, or to find the address of the current 
CCW so you can examine it. 

2. The three low-order bits of the command address field must be zeros 
in order for the CCW to be on a doubleword boundary. If the CCW is 
not on a doubleword boundary or if the command address specifies a 
location protected from fetching or outside the storage of a 
particular user, the Start I/O instruction causes the status 
portion of the CSW to be stored with the program check or 
protection check bit on. In this event, the I/O operation is not 
initiated. 

Responses 

The CAW, located at storage location X'48 1 , is displayed. Its format is: 

| KEY | 0000 | Command Address 

i 

3 4 7 8 31 

5i£s Contents 

0-3 The protection key for all commands associated with Start I/O. 

The protection key in the CAW is compared to a key in storage 

whenever a reference is made to storage. 

4-7 This field is not used and must contain binary zeros. 

8-31 The command address field contains the storage address (in 
hexadecimal representation) of the first CCW (channel command 
word) associated with the next or most recent Start I/O. 
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csw 



Use the CSW subcommand to display at the terminal the contents of the 
CSW (Channel Status Word) , as it existed at the time the debug 
environment was entered. The format of the CSW subcommand is: 

| CSW | 



U§liije Notes 

1. The CSW indicates the status of the channel or an input/output 
device, or the conditions under which an I/O operation terminated. 
The CSW is formed in the channel and stored in storage location 
X^O 1 when an I/O interrupt occurs. if I/O interrupts are 
suppressed, the CSW is stored when the next Start I/O, Test I/O, or 
Halt I/O instruction is executed. 

2. Whenever an I/O operation abnormally terminates, issue the CSW 
subcommand. The status and residual count information in the CSW 
is very useful in debugging. Also, use the CSW to calculate the 
address of the last executed CCW (subtract 8 bytes from the command 
address to find the address of the last CCW executed) . 

Responses 

The contents of the CSW are displayed at the terminal in hexadecimal 
representation. Its format is: 

| KEY | 0000 | Command Address | Status | Byte Count | 

3 4 7 8 31 32 47 48 63 

li^s Contents 

0-3 The protection key is moved to the CSW from the CAW. It 
indicates the protection key at the time the I/O operation 
started. The contents of this field are not affected by 
programming errors detected by the channel or by the condition 
causing termination of the operation. 

4-7 This field is not used and must contain binary zeros. 

8-31 The command address contains a storage address (in hexadecimal 
representation) that is 8 bytes greater than the address of 
the last CCW executed. 

32-47 The status bits indicate the conditions in the device or 
channel that caused the CSW to be stored. 

48-63 The residual count is the difference between the number of 
bytes specified in the last executed CCW and the number of 
bytes that were actually transferred. When an input operation 
is terminated, the difference between the original count in 
the CCW and the residual count in the CSW is equal to the 
number of bytes transferred to storage; on an output 
operation, the difference is equal to the number of bytes 
transferred to the I/O device. 



266 IBM VM/370: CMS Command and Macro Reference 



DEBUG Subcommands-DEFINE 

DEFINE 

Use the DEFINE subcommand to assign a symbolic name to a specific 
storage address. Once a symbolic name is assigned to a storage address, 
that symbolic name can be used to refer to that address in any of the 
other DEBUG subcommands. The format of the DEFINE subcommand is: 



II r i 

| DEFine | symbol hexloc |bytecount| 

II I H I 

II L J 

i : 



where : 

symbol is the name to be assigned to the storage address derived 
from the second operand, hexloc. Symbol may be from 1 to 8 
characters long, and must contain at least 1 nonhexadecimal 
character. Any symbolic name longer than 8 characters is 
left- justified and truncated on the right after the eighth 
character. 

hexloc is the hexadecimal storage location, in relation to the 
current origin, to which the name specified in the first 
operand (symbol) , is assigned. 

bytecount is a decimal number, between 1 and 56 inclusive, which 
specifies the length in bytes of the field whose name is 
specifed by the first operand (symbol) and whose starting 
location is specified by the second operand (hexloc) . When 
bytecount is not specified, 4 is assumed. 

Usage Notes 

1. Issuing the DEFINE subcommand creates an entry in the debug symbol 
table. The entry consists of the symbol name, the storage address, 
and the length of the field. A maximum of 16 symbols can be 
defined in the debug symbol table at a given time. 

2. When a DEFINE subcommand specifies a symbol that already exists in 
the debug symbol table, the storage address derived from the 
current reguest replaces the previous storage address. Several 
symbols may be assigned to the same storage address, but each of 
these symbols constitutes one entry in the debug symbol table. The 
symbols remain defined until they are redefined or until an IPL 
subcommand loads a new copy of CHS. 

3. When you assign a symbolic name to a storage location, you must 
know the current origin (set by the ORIGIN subcommand) . The hexloc 
you specify is added to the current origin to create the entry in 
the symbol table used by DEBUG subcommands. If you change the 
current origin, existing entries are not changed. 

4. You can use the symbolic names to refer to storage locations when 
you issue the DEBUG subcommands BREAK, DUMP, GO, ORIGIN, STORE, and 
X. 

Responses 
None. 
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DUMP 



Use the DUMP subcommand to print part or all of your virtual storage on 
the printer. The requested information is printed offline as soon as 
the printer is available. First, a heading: 

ident FROM starting location TO ending location 

is printed. Next, the general registers 0-7 and 8-15, and the 
floating-point registers 0-6 are printed, followed by the PSH, CSW, and 
CAW. Then the specified portion of virtual storage is printed with the 
storage address of the first byte in the line printed at the left, 
followed by the alphameric interpretation of 32 bytes of storage. The 
format of the DUMP subcommand is: 



DUmp 



I symbol 1 
| hexlod 
I 



| symbol2 
I hexloc2 
I * 
I 32 



[ident ] 



i i 



I I 



where : 
symboll 

hexlod 

symbol2 

hexloc2 



ident 



is the name assigned (via the DEFINE subcommand) to the 
storage address that begins the dump. 

is the hexadecimal storage location, in relation to current 
origin, that begins the dump. 

is the name assigned (via the DEFINE subcommand) to the 
storage address that ends the dump. 

is the hexadecimal storage location, in relation to the 
current origin, that ends the dump. 

indicates that the dump ends at your virtual machine's last 
virtual storage address. 

is any name (up to eight characters) that identifies the 
dump. 



1. If you issue the DUMP subcommand with no operands, 32 bytes of 
storage are dumped, starting at the current origin. 

2. The first and second operands must designate storage addresses that 
do not exceed your virtual machine storage size. Also, the storage 
address derived from the second operand must be greater than the 
storage address derived from the first operand. 



Responses 
None. 
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GO 

Use the GO subcommand to exit from the debug environment and begin 
program execution. The format of the GO subcommand is: 

I I r i I 

| GO | | symbol | | 

| | | hexloc | I 

I I L J I 



w h er e : 

symbol is the symbolic name assigned to the storage location where 
you want execution to begin. 

hexloc is the hexadecimal location, in relation to the current 
origin, where you want execution to begin. 

Usacje ^2i£§ 

1. When you issue the GO subcommand, the general registers, CAW 
(channel address word) ,, and CSW (channel status word) are restored 
either to their contents upon entering the debug environment, or, 
if they have been modified, to their modified contents. Then the 
old PSW is loaded and becomes the current PSW. Execution begins at 
the instruction address contained in bits 40-63 of the PSW. 

2. When you specify symbol or hexloc with the GO subcommand, the 
specified address replaces the instruction address in the old PSW, 
so execution will begin at that address. If you entered the debug 
environment with the DEBUG command, you must specify an address 
with the GO subcommand. 

3. The address you specify must be within your virtual machine and it 
must contain a valid operation code. 

Responses 

Program execution is resumed. 
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GPR 

Use the GPR subcommand to display the contents of one or more general 
registers at the terminal. The format of the GPR subcommand is; 

r- 

| GPR | regl [reg2] 
c_ 

w h er e : 

regl is a decimal number (from 0-15 inclusive) indicating the first 
or only general register whose contents are to be displayed. 

reg2 is a decimal number (from 0-15 inclusive) indicating the last 
general register whose contents are to be displayed. reg2 must 
be larger than regl. 

Responses 

The register or registers specified are displayed, in hexadecimal 
representation : 

xxxxxxxx 



HX 

Use the HX subcommand to leave the debug environment, regardless of the 
reason the debug environment was entered. The format of the HX 
subcommand is: 

I HX 

L_._ 



Responses 

If you entered the debug environment following a program interrupt, you 
receive the message 

CMS 

to indicate a return to the CMS environment. If you entered the debug 
environment by issuing the DEBUG command, you receive the message 

DMSABN1U8T SYSTEM ABEND 2E4 CALLED FROM XXXXXX 

where xxxxxx is the address of the debug routine. 
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ORIGIN 

Use the ORIGIN subcommand to set an origin or base address to be used in 
the debug environment. The format of the ORIGIN subcommand is: 

| ORigin | (symbol) I 

| | < hexloc > I 

I I I j | 

where : 

symbol is a symbolic name that was previously assigned (via the 
DEFINE subcommand) to a storage address. 

hexloc is a hexadecimal location within the limits of your virtual 
storage. If you do not explicitly set an origin, then it has 
a value of 0. 

IZsacje Notes 

1. When the ORIGIN subcommand specifies a symbol, the debug symbol 
table is searched. If a match is found, the value corresponding to 
the symbol becomes the new origin. When a hexadecimal location is 
specified, that value becomes the origin. In either case, the 
operand cannot specify an address greater than your virtual storage 
size. 

2. Any origin set by an ORIGIN subcommand remains in effect until 
another ORIGIN subcommand is issued, or until you obtain a new copy 
of CMS. Whenever a new ORIGIN subcommand is issued, the value 
specified in that subcommand overlays the previous origin setting. 
If you obtain a new copy of CMS (via IPL) , the origin is set to 
until a new ORIGIN subcommand is issued. 

3. You can use the ORIGIN subcommand to set the origin to your 
program»s base address, and then refer to actual instruction 
addresses in your program, rather than to virtual storage 
locations. 

Responses 
None. 



Section 4. DEBUG Subcommands 271 



DEBUG Subcommands-PSW, RETURN 

PSW 

Use the PSW subcommand to display the contents of the PSW (program 
status word) . The format of the PSW subcommand is: 



I PSW 

L_ 



Usage Notes 

1. If the debug environment was entered because of a program 
interrupt, the program old PSW is displayed. If the debug 
environment was entered because of an external interrupt, the 
external old PSW is displayed. If the debug environment was 
entered for any other reason, the following is displayed in 
response to the PSW subcommand: 

OlOOOOOOxxxxxxxx 

where the 1 in the first byte means that external interrupts are 
allowed and xxxxxxxx is the hexadecimal storage address of the 
debug program. 

2. The PSW contains some information not contained in storage or 
registers but required for proper program execution. In general, 
the PSW is used to control instruction sequencing and to hold and 
indicate the status of the system in relation to the program 
currently executing. Refer to "Appendix A: System/370 Information" 
in the VM^370: System Programmer's Guide for a description of the 
PSW. 

Responses 

The PSW is displayed in hexadecimal representation as follows: 
xxxxxxxxxxxxxxxx 



RETURN 

Use the RETURN subcommand to exit from the debug environment and enter 
the CMS command environment. The format of the RETURN subcommand is: 

I RETurn 
i . 



Usage Notes 

1. The RETURN subcommand is valid only when the debug environment was 
entered via the DEBUG command. 

Responses 

The CMS Ready message indicates that control has been returned to the 
CMS environment. 
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SET 

Use the SET subcommand to change the contents of the control words and 
general registers. The format of the SET subcommand is: 



SET | ( CAW hexinf o 

hexinfo [ hexinf o] 
hexinf o [hexinfo] 

reg hexinfo [hexinfo] J I 

„j 

where : 

CAW hexinfo 

stores the specified information (hexinfo) in the CAW (channel 
address word) that existed at the time the debug environment 
was entered. 

CSW hexinfo [hexinfo] 

stores the specified information (hexinfo [hexinfo]) in the 
CSW (channel status word) that existed at the time the debug 
environment was entered. 

PSW hexinfo [hexinfo] 

stores the specified information (hexinfo [hexinfo]) in the 
old PSW (program status word) for the interrupt that caused 
the debug environment to be entered. 

GPR reg hexinfo [hexinfo] 

stores the specified information (hexinfo [hexinfo]) in the 
specified general register (reg) . 

Usage Notes 

1 . The SET subcommand can only change the contents of one control word 
at a time. For example, you must issue the SET subcommand three 
times: 

set caw hexinfo 

set csw hexinfo [hexinfo] 

set psw hexinfo [hexinfo] 

to change the contents of the three control words. 

2. The SET subcommand can change the contents of one or two general 
registers each time it is issued. When four or fewer bytes of 
information are specified, only the contents of the specified 
register are changed. When more than four bytes of information are 
specified, the contents of the specified register and the next 
seguential register are changed. For example, the SET subcommand: 

set gpr 2 xxxxxxxx 

changes only the contents of general register 2. But, the SET 
subcommand: 

set gpr 2 xxxxxxxx xxxxxxxx 

changes the contents of general registers 2 and 3. 

3. Each hexinfo operand should be from 1- to 4 bytes long. If an 
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operand is less than 4 bytes and contains an uneven number of 
hexadecimal digits (representing half-byte information) , the 
information is right- justified and the left half of the uneven byte 
is set to zero. If more than 8 hexadecimal digits are specified in 
a single operand, the information is left-justified and truncated 
on the right after the eighth digit. 

4. The number of bytes that can be stored using the SET subcommand 
varies depending on the form of the subcommand. With the CAW form, 
up to 4 bytes of information may be stored. With the CSW, GPR, and 
PSW forms, up to 8 bytes of information may be stored, but these 
bytes must be represented in two operands of 4 bytes each. When 
two operands of information are * specified, the information is 
stored in consecutive locations (or registers) , even if one or both 
operands contain less than 4 bytes of information. 

Responses 

None. To display the contents of control words or registers after you 
modify them, you must use the CAW, CSW, PSW, and GRP subcommands. 



STORE 

Use the STORE subcommand to store up to 12 bytes of hexadecimal 
information in any valid virtual storage location. The format of the 
STORE subcommand is: 

I STore | ( symbol | hexinfo [hexinfo [hexinfo]] I 

I I \hexloc/ I 

where : 

symbol is the symbolic name assigned (via the DEFINE subcommand) to 
the storage address where the first byte of specified 
information is to be stored. 

hexloc is the hexadecimal location, relative to the current origin, 
where the first byte of information is to be stored. 

hexinfo is the hexadecimal information, four bytes or less in length 
(that is, 2 to 8 hexadecimal digits) , to be stored. 

Usage Notes 

1. If an operand is less than 4 bytes long and contains an uneven 
number of hexadecimal digits (representing half-byte information) , 
the information is right- justified and the left half of the uneven 
byte is set to zero. If more than 8 hexadecimal digits are 
specified in a single operand, the information is left- justified 
and truncated on the right after the eighth digit. 

2. The STORE subcommand can store a maximum of 12 bytes at one time. 
By specifying all three information operands, each containing four 
bytes of information, the maximum 12 bytes can be stored. If less 
than four bytes are specified in any or all of the operands, the 
information given is arranged into a string of consecutive bytes, 
and that string is stored starting at the location derived from the 
first operand. 
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For example, if you have defined a 4-byte symbol named FENCE that 
currently contains X'FFFFFFFF' and you enter 

store fence 

FENCE contains X»00FFFFFF«. 



Responses 

None. To display the contents of a storage location after you have 
modified it, you must use the X subcommand. 



Use the X subcommand to examine and display the contents of specific 
locations in virtual storage. The format of the X (examine) subcommand 
is: 



r t 

symbol | n | 

I i^Sa^h | 

L J 



hexloc | n 

I a 

L 



where : 

symbol n is the name assigned (via the DEFINE subcommand) to the 
storage address of the first byte to be displayed, n is a 
decimal number from 1 to 56 inclusive, that specifies the 
number of bytes to be examined. If a symbol is specified 
without a second operand, the length attribute associated with 
that symbol in the debug symbol table specifies the number of 
bytes to be examined. 

hexloc n is the hexadecimal location, in relation to the current 
origin, of the first byte to be examined. If hexloc is 
specified without a second operand, 4 bytes are displayed. 

1 . The address represented by symbol or hexloc must be within your 
virtual machine storage size. 

Responses 

The reguested information is displayed at the terminal in hexadecimal 
format. 
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Section 5. EXEC Control Statements 



This section describes the formats, usage rules, and default values for 
EXEC control words, including 

• Control Statements 

• Built-in Functions 

• Special Variables 

An EXEC procedure is a CMS file that contains a sequence of CMS 
commands and/or EXEC control statements. Control statements determine 
the logic flow for EXEC, provide terminal communications, and may be 
used to manipulate CMS disk files. For an introduction to the EXEC 
facilities, and for complete tutorial information, including examples, 
consult the VM/370: CMS User^s Guide. 

EXEC procedures may be invoked with the EXEC command, described in 
"Section 2. CMS Commands." You may also excute an EXEC procedure by 
specifying its filename, as long as the implied EXEC function is in 
effect. 
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The Assignment Statement 

Use the assignment statement in an EXEC procedure to assign a value to a 
variable symbol. Variable symbols may be tested and manipulated to 
control the execution of an EXEC procedure. The format of the 
assignment statement is: 

| t string ) I 

| Svariable = 1 ae 

I \ function 

| ( X'xxxxxx 

where ;: 

Svariable indicates the variable symbol which is assigned the 
specified value. A variable may contain a maximum of eight 
alphameric characters, including the initial ampersand, 
which is reguired. 

string is a 1- to 8-character data item. It may also be a variable 
symbol. Whether a numeric string is treated as numeric or 
character data depends on how it is used in the EXEC. If a 
string containing variable symbols expands to more than 8 
characters, it is truncated. 

ae is an arithmetic expression, consisting of a seguence of 

data items that possess positive or negative integral values 
and are separated by plus or minus signs: 

&1 - 4 + &CALC - 6 

function is an EXEC built-in function followed by at least one 
token. 

X'xxxxxx indicates up to 6 hexadecimal digits to be converted to 
decimal before assignment. For example: 

&A = X'CO 

results in &A having the decimal value 192. 

Hexadecimal conversion is not performed unless you have used 
the &HEX ON control statement. 

Variable Substitution 

All variable symbols occurring in executable statements are substitued 
before the statement is executed. An executable statement is (1) a CMS 
command line, or (2) an EXEC control statement (including assignment 
statements) . 

Variable substitution is not performed on symbols on the left-hand 
side of an assignment statement,. If that variable has already been 
assigned a value, it is replaced by the new value specified in the 
assignment statement. 

| If the special form, X'&symbol is used, the specified symbol is 
| converted to its hexadecimal eguivalent. For example, 

I 6A = 192 
| &TYPE X'&A 
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| results in the display 

I CO 

If a variable symbol that has not been defined is used in an 
executable statement, the symbol is set to a null token, and ignored. 
In some instances this may cause an EXEC processing error. 

Tokens 

All executable statements in an EXEC are scanned into 8-character 
tokens, and padded or truncated as necessary. Tokens are formed of words 
delimited by blanks and parentheses, for example, the line 

&TYPE THIS IS AN EXAGGERATED (MESSAGE 

scans as 

&TYPE THIS IS AN EXAGGERA ( MESSAGE 

Variable symbols are substituted after each line is scanned, and each 
token is scanned repeatedly until all symbols in it are substituted. 



&ARGS 

Use the &ARGS control statement to redefine the value of one or more of 
the special variables, &1 through &30. The format of the &ARGS control 
statement is: 



| &ARGS | [argl [ arg2 ... [arg30] ] ] 



where : 

[argl [ arg2 ... [arg30]]] 

specify up to 30 tokens to be assigned to the special 
variables &1 through &30. If no arguments are specified, all 
of the variables S1 through &30 are set to blanks. When fewer 
than 30 arguments are entered, the remaining arguments are set 
to blanks. 

H§§a§ Jlotes 

1. To enter an argument list from the terminal, use the &READ ARGS 
control statement. 

2. An SARGS control statement resets the values of the 6INDEX, £* and 
&$ special variables. 



I &BEGEMSG 

| Use the SBEGEMSG control statement to introduce one or more unscanned 
| lines to be edited as VM/370 error messages. The list of lines to be 
I displayed must be terminated by an &END control statement, which must 
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appear beginning in column 1. The format of the SBEGEMSG control 
statement is: 

| SBEGEMSG | [ALL] I 

w h er e : 

ALL specifies, for fixed-length EXEC files, that the entire line (to a 
maximum of 130 characters) is to be displayed. 

Usacje Notes 

1. To gualify for error message editing, the first data item on each 
line following the &BEGEMSG control statement must be 7 characters 
long, in the format: 

mmmnnns 

where : 

mmmnnn is a 6-character message identification you can supply for 
the error message. Standard VM/370 error messages use a 
3-character module code (mmm) and a 3-character message 
number (nnn) . 

s indicates the severity code. The following codes gualify 
the message for error message editing: 

Code Message Type 

I Information 

E Error 

W Warning 

When the severity code is E, I or W, the message is 
displayed in accordance with the CP EMSG setting (ON, OFF, 
CODE, or TEXT) . You can change this setting with the CP 
SET command, described in VM^.370: CP Command Reference for 
General Users. 

2. When you use the SBEGEMSG control statement to display error 
messages, the character string •DMS» is inserted in front of the 
7-character message identification. For example, if the EMSG 
setting is ON, the lines 

SBEGEMSG 

TEST01E INSURMOUNTABLE ERROR 

SEND 

result in the display 

DMSTEST01E INSURMOUNTABLE ERROR 

Note: Since the maximum length of a line that you can display at 
your terminal is 132 characters, the insertion of the characters 
DMS will cause lines greater than 129 characters long to be 
truncated. 

4. Messages that are displayed as the result of an SBEGEMSG control 
statement are not scanned by the EXEC interpreter. Therefore, no 
variable substitution is performed and no data items are 
truncated. To display variable data, use the &EMSG control 
statement. 
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&BEGPUNCH 

Use the &BEGPUNCH control statement to delimit the beginning of a list 
of one or more data lines to be spooled to your virtual card punch. The 
list of lines to be punched is terminated by the control statement SEND, 
which must occur beginning in column 1. The format of the &BEGPUNCH 
control statement is: 

| SBEGPUNCH | [ALL] 

w h er e : 

ALL specifies that data occupying columns 73 through 80 should be 
punched. If ALL is not specified, input records are truncated 
at column 72 and columns 73 through 80 of the output record 
are padded with blanks. 

1. Lines that are punched as the result of an SBEGPUNCH control 
statement are not scanned by the EXEC interpreter. Therefore, no 
variable substitution is performed and no data items are truncated. 
To punch variable data, you must use the &PUNCH control statement. 

2. When you are finished punching lines in an EXEC procedure, you 
should use the CP CLOSE command to close your virtual punch. 



&BEGSTACK 

Use the &BEGSTACK control statement to delimit the beginning of a list 
of one or more data lines to be placed in the console input stack. The 
list of lines to be stacked is terminated by the control statement SEND 
which must occur beginning in column 1. The format of the SBEGSTACK 
control statement is: 



I I r i r n 

| SBEGSTACK | I FIFO | | ALL | 

I I |LIFO| •- J 

I I L J 



where: 



FIFO specifies that the lines that follow are to be stacked on a 
first in, first out basis. This is the default value. 

LIFO specifies that the lines that follow are to be stacked on a 
last in, first out basis. 

ALL specifies, for fixed-length EXEC files, that the entire line 
(to a maximum of 130 characters) is to be stacked. If ALL is 
not specified, the lines are truncated in column 72. 
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Usage Notes 

1. Lines that are stacked as the result of an &BEGSTACK control 
statement are not scanned by the EXEC interpreter. Therefore , no 
variable substitution is performed, and data items are not 
truncated. To stack variable data, you must use the &STACK control 
statement. 

2. To stack a null line in an EXEC file you must use the &STACK 
control statement. A null line following an SBEGSTACK control 
statement is interpreted as a line of blanks. To stack an INPUT or 
REPLACE subcommand to enter input mode from a fixed-length EXEC, 
you should use the &STACK control statement. 



&BEGTYPE 

Use the SBEGTYPE control statement to delimit the beginning of a list of 
one or more data lines to be displayed at the terminal. The list of 
lines to be displayed is terminated by the control statement &END, which 
must occur beginning in column 1. The format of the &BEGTYPE control 
statement is: 

| SBEGTYPE | [ALL] I 

where : 

ALL specifies, for fixed-length EXEC files, that data occupying 
columns 73 through 130 is to be displayed. If ALL is not 
specified, the lines are truncated at column 72. 

1. Lines that are displayed as the result of an SBEGTYPE control 
statement are not scanned by the EXEC interpreter. Therefore, no 
variable substitution is performed, and data items are not 
truncated. To display variable data, you must use the &TYPE 
control statement. 



&CONTINUE 

Use the SCONTINUE control statement to instruct the EXEC interpreter to 
process the next statement in the EXEC file. The format of the 
SCONTINUE control statement is: 

| SCONTINUE 
i 



H§^a® Notes 

1. SCONTINUE is generally used in conjunction with an EXEC label (for 
example, -LAB SCONTINUE) to provide a branch address for SERROR, 
SGOTO, and other branching statements. SCONTINUE is the default 
action taken when an error is detected in processing a CMS 
command. 
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&CONTROL 



Use the &CONTROL control statement to specify the amount of data to be 
displayed in the execution summary of an EXEC. The format of the 
&CONTROL control statement is: 



r „. 

| 6C0NTR0L 

• 


r t 

|OFF | 
| ERROR | 
|CMS | 
|ALL | 

L J 


r t 
|MSG | 
INOMSGI 

L J 


r i 
|TIME | 
1 1ST IM E | 

L "~ J 


r t 

|PACK | 
|NOPACK| 

L J 


where : 

OFF supi 


Dresses the 


display 


Of CMS 


commands an< 



statements as they execute, and any return codes that may 
result from CMS commands. 



ERROR 



CMS 



displays only those CMS commands that result in an error and 
also displays the error message and the return code. 

displays each CMS command as it is executed and all nonzero 
return codes. 



ALL 



displays CMS commands and EXEC executable statements as they 
execute as well as any nonzero return codes from CMS 
commands. 



MSG does not suppress the "FILE NOT FOUND" message if it is issued 
by the following commands when they are invoked from an EXEC 
procedure: ERASE, LISTFILE, RENAME, or STATE. 

NOMSG suppresses the "FILE NOT FOUND" message if it is issued when 
the ERASE, LISTFILE, RENAME, or STATE commands are invoked 
from an EXEC procedure. 

TIME includes the time— of-day value with each CMS command printed 
in the execution summary, for example: 

14:36:30 TYPE A B 



NOTIME 



PACK 



NOPACK 



This operand is effective only if CMS or ALL 
specified. 



is also 



does not include the time— of-day value with 
printed in the execution summary. 



CMS commands 



packs the lines of the execution summary so that surplus 
blanks are removed from the displayed lines. 

does not pack the lines of the execution summary. 



S§age Notes 

1. The execution summary may consist of CMS commands, responses, error 
messages, and return codes, as well as EXEC control statements and 
assignment statements. When EXEC statements are displayed, they 
are displayed in their scanned format, with all variable symbols 
substituted. 
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2. Each operand remains set until explicity reset by another SCONTROL 
statement which specifies a conflicting operand. When SCONTROL is 
used with no operands, all operands are reset to their default 
values. 



I &EMSG 

Use the SEMSG control statement to display a line of tokens to be edited 
as a VM/370 error message. The format of the &EMSG control statement is: 



| SEMSG j mmmnnns [tokl ... [tokn]] 



where : 

mmmnnn is a 6-character identification you may supply for the error 
message. Standard VM/370 messages are coded using a 
3-character module code (mmm) and a 3-character message number 
(nnn) . 

s indicates the severity code. The following codes gualify the 
message for error message editing: 

Code Message TyjDe 

I Information 

E Error 

W Warning 

tokl ...[tokn] 

is the text of the message to be displayed. 

Usage Notes 

1. When the severity code is I, E r or W, the message is displayed in 
accordance with the CP EMSG setting (ON, OFF, CODE, or TEXT) . You 
can change the setting with the CP SET command, described in 
II5Z1Z9. : C.P Command Reference for General Users. 

2. When an SEMSG code is displayed, it is prefixed with DMS. For 
example, the statement 

SEMSG ERR0R1E INVALID ARGUMENT 

displays as follows when the EMSG setting is ON: 

DMSERR0R1E INVALID ARGUMENT 

3. To display an error message with unsubstituted data, or to display 
a line with words of more than 8 characters, use the &BEGEMSG 
control statement. 
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&END 

I Use the SEND control statement to terminate a list of one or more lines 
| that began with an SBEGEMSG, SBEGPUNCH, SBEGS*TACK, or SBEGTYPE control 
| statement. The format of the SEND control statement is: 

I SEND | I 

The word "SEND" must be entered beginning in column 1. 



&ERROR 

Use the SERROR control statement to specify the action to be taken when 
a CMS command results in an error and returns with a nonzero return 
code. The format of the SERROR control statement is: 



i r i 

SERROR | | executable-statement | 

I I &CONTIN UE | 



wh er e : 

executable-statement 

specifies any executable statement, which may be an EXEC control 
statement or assignment statement or a CMS command. If you specify 
an EXEC control statement that transfers control to another line in 
the EXEC, execution continues at the specified line. Otherwise, 
execution continues with the line following the CMS command line that 
caused the error. 

M§§3§ Notes 

1. If your EXEC does not contain an SERROR control statement, then the 
default is SCONTINUE, that is, EXEC processing is to continue with 
the line following the CMS command that caused the error. You can 
use SERROR SCONTINUE to reset a previous SERROR statement. 

2. The words following an SERROR control statement are not scanned 
until a CMS command returns a nonzero return code. Therefore, if 
you specify an invalid EXEC statement, the error is not detected 
until a CMS command failure triggers the SERROR statement. If the 
SERROR statement executes a CMS command that also results in an 
error, EXEC processing is terminated. 
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&EXIT 

Use the ©EXIT control statement to terminate processing the EXEC file. 
If the exit is taken from a first-level EXEC procedure, control passes 
to CMS. If the exit is taken from a nested EXEC procedure, control 
passes to the calling EXEC procedure. The format of the &EXIT control 
statement is: 

I I r i I 

I &EXIT | | return-code | I 

I I I | | 

I I L J I 

where : 

return-code 

specifies a numeric value (which may be a variable symbol) , to 
be used as the return code from this EXEC. If not specified, 
is assumed. 

H§«ii3ii Notes 

1. If control is returned to the CMS, the CMS Ready message indicates 
the return code value. Thus, the statement 

&EXIT 12 

results in the Ready message 

R (00012) ;T=0/02 15:32:34 

2. If you specify 

&EXIT 6RETC0DE 

the return code value displayed is the return code from the most 
recently executed CMS command. 
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&GOTO 

Use the SGOTO control statement to transfer control to a specific 
location in the EXEC procedure. Execution then continues at the 
location that is branched to. The format of the SGOTO control statement 
is: 

TOP ) I 

line— number > I 

-label I I 

transfers control to the first line of the EXEC file. 

transfers control to a specific line in the EXEC file. 

transfers control to a specific label in the EXEC file. A 
label must begin with hyphen (minus sign) , and it must be 
the first token on a line. The remainder of the line may 
contain an executable statement or it may be null. 

Usage Notes 

1. Scanning for an EXEC label starts on the line following the &GOTO 
statement, goes to the end of the file, then to the top of the 
file, and (if unsuccessful) ends on the line above the SGOTO 
statement. If more than one statement in the file has the same 
label, the first one encountered by these rules satisfies the 
search. 

2. To provide a branch a specific number of lines up or down in the 
EXEC, use the &SKIP control statement. 



I &HEX 

Use the SHEX control statement to initiate or inhibit hexadecimal 
conversion in an EXEC procedure. The format of the SHEX control 
statement is: 



SHEX | /ON ) 
I I Oil J 



I 



where: 



ON indicates that tokens beginning with the string X 1 are to be 
interpreted as hexadecimal notation. 

OFF indicates that no hexadecimal conversion is to be done by EXEC. 
OFF is the default setting. 

Usage Notes 

1. You should use the SHEX control statement when you want to display 
a hexadecimal value. For example. 
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SHEX ON 
STYPE X»40 
SHEX 

results in the display 

28 

If you did not use the SHEX ON control statement, the &TYPE 
statement would result in the display 

X«40 

2. To convert a hexadecimal value to its decimal equivalent, use an 
assignment statement. 



&IF 

Use the &IF control statement to test a condition in an EXEC procedure 
and to perform a particular action if the test is valid. If the test is 
invalid, execution continues with the statement following the SIF 
control statement. The format of the SIF statement is: 



executable-statement 



w her e : 

tokenl may be numeric constants, character strings, or EXEC variable 
token2 symbols. All variable symbols are substituted before the SIF 
statement is executed. 

&* tests all of the arguments entered when the EXEC was invoked. 
All of the entered arguments must meet the specified condition 
in order for the SIF statement to be true. 

&$ tests all of the arguments entered when the EXEC was invoked. 
If at least one of the arguments satisfies the specified 
condition, the SIF statement is true. 

operator indicates the test to be performed on the tokens. If both 
tokens are numeric, an arithmetic test is performed. 
Otherwise, a logical (alphabetic) test is performed. The 
comparison operators, listed below, may be specified either in 
symbolic or mneumonic form: 

Symbol Operation 

= or EQ equals 

-•= or NE not equal 

< or LT less than 

<= or LE less than or equal to (not greater than) 

> or GT greater than 

>= or GE greater than or equal to (not less than) 

executable- statement 

is any valid EXEC executable statement which may be a CMS ^ 
command, or EXEC control statement or assignment statement. 
You may also specify another SIF statement; the number of SIF 
statements that may be nested is limited only by the record 
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length of the file. In fixed-length EXEC files, only the 
first 72 characters of the line are scanned. 



Usage Notes 

| 1. The values S* and &$ are reset when an &ARGS or &READ ARGS control 
| statement is executed. They are not changed when you reset a 
| specific numeric variable (&1 through &30) . 

2. If a variable symbol used in an &IF control statement is undefined, 
the EXEC interpreter cannot properly compare it. In cases where a 
variable may be null, or to check for a null symbol, you should use 
a concatenation character when you write the SIF statement, for 
example 

&IF .&1 EQ . SGOTO -NOARGS 

tests for a null symbol &1. 

3. If the symbols &* or &$ are null because no arguments were entered, 
the entire &IF statement is treated as a null statement. 



&LOOP 



Use the &LOOP control statement to describe a loop in an EXEC procedure, 
including the conditions for exit from the loop. The format of the 
SLOOP control statement is: 



| &LOOP 
I 



rn Wm ) 
(—label/ (condition/ 



„___j 



w h er e : 
n 

-label 



condition 



is a positive integer from to 4095 that indicates the 
number of lines to be executed in the loop. These lines 
must immediately follow the &LOOP statement. 

specifies that all of the lines following the &L00P 
statement down to, and including the line with the specified 
label, are to be executed in the loop. The first character 
of the label must be a hyphen, and it must be the first 
token on a line. The remainder of the line may contain an 
executable statement, or it may be null. 



is a positive integer from to 4095 that indicates 
number of times the loop is to be executed. 



the 



specifies the condition that must be met. The syntax of the 
exit condition is the same as that in the SIF statement, 
that is: 



operator 





Section 5. EXEC Control Statements 



289 



EXEC Control Statements-&LOOP, &PUNCH 

Usacje Notes 

1. When loop execution is complete, control passes to the next 
statement following the end of the loop. 

2. The condition is always tested before the loop is executed. If the 
specified condition is met, then the loop is not executed. For 
example, the statement 

SLOOP 3 &COUNT = 100 

specifies that the next three statements are to be executed until 
the value of &C0UNT is 100. 

3. Loops may be nested up to four levels deep. All nested loops may 
end at the same label. 



&PUNCH 

Use the &PUNCH control statement to punch a line of tokens to the 
virtual card punch. The format of the &PUNCH control statement is: 



| &PUNCH | [tok! [tok2 ... [tokn]]] 



where : 

tokl [tok2 ... [tokn]] 

specifies the tokens to be punched. All tokens are padded and 
truncated to 8 characters, as necessary. The punched line is 
right-padded with blanks to fill an 80-column card. If no tokens 
are specified, a line consisting of 80 blank characters is 
punched. 

Usage Notes 

1. Lines punched with the &PUNCH control statement are scanned by the 
EXEC interpreter and variable symbols are substituted before the 
line is punched. In fixed-length EXEC files, only the first 72 
characters of the record are scanned. To punch one or more lines 
of unscanned data, use the &BEGPUNCH or &BEGP0NCH ALL control 
statement. 

2. When you have finished punching lines in an EXEC procedure, you can 
use the CP command CLOSE to close the spool punch file and release 
it for processing. 
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&READ 



Use the &READ control statement to read one or more lines from the 
terminal or console stack. The lines may contain data or executable 
statements. The format of the &READ control statement is: 



&READ 



I n 

I 1 

IARGS 

I VARS [&var1 

L 



[&var2 



[Svarn]]]| 

j 



i 



where: 



reads the next n lines from the terminal and treats them as if 
they had been in the EXEC file. Reading from the terminal 
stops when n lines have been read, or when an &LOOP statement 
or a statement that transfers control is encountered. If an 
&READ statement is encountered, the number of lines to be read 
by it is added to the number outstanding. 



If n is not specified, 1 is assumed, and the 
processing after reading a single line. 



EXEC continues 



ARGS 



reads a single line, assigns the entered tokens to the special 
variables &1, &2, ..., &n, and resets the special variables 
&INDEX, &*, and &$. 



VARS [&var1 [&var2 ... [Svarn]]] 

reads a single line and assigns the tokens entered to the 
variable symbols svarl, &var2, . . . ,varn (up to 17). 

These variables are scanned in the same way as if they 
appeared on the left-hand side of an assignment statement. If 
no variable names are specified, any data read from the 
terminal is lost. 

H§»acje Notes 

1. You can test the special variable SREADFLAG to determine whether 
the next &READ statement will result in a physical read to your 
terminal (the value of &READFLAG is CONSOLE) or in reading a line 
from the console stack (the value of &READFLAG is STACK) . 



&SKIP 



Use the &SKIP control statement to cause a specified number of lines in 
the EXEC file to be skipped. The format of the SSKIP control statement 
is: 



i 



I I r i 

| &SKIP | | n | 

I I I 1 I 

I I L J 

i 
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wh er e : 

n specifies the number of lines to be skipped: 

• If n is greater than 0, the specified number of lines are 
skipped. Execution continues on the line following the skipped 
lines. If the value of n surpasses the number of lines 
remaining in the file, the EXEC terminates processing. 

• If n is equal to 0, no lines are skipped, and execution 
continues with the next line. 

• If n is less than 0, execution continues with the line that is n 
lines above the current line. An attempt to skip beyond the 
beginning of the file results in an error exit from the EXEC. 

n may be coded as a variable symbol; if no value is specified, 1 is 
assumed. 

1. To pass control to a particular label in an EXEC procedure, use the 
&G0T0 control statement. The SGOTO control statement provides more 
flexibility when you want to update your EXEC procedures. The 
&SKIP statement, however, is more efficient, in terms of execution 
time. 



&SPACE 

Use the &SPACE control statement to display a specified number of blank 
lines at your terminal. The format of the &SPACE control statement is: 




w her e : 

n specifies the number of blank lines to be displayed at the 
terminal. If no number is specified, &SPACE 1 is assumed by 
default. 

Usage Notes 

1. You may want to use the &SPACE control statement to control the 
format of the execution summary that displays while your EXEC 
executes. 
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&STACK 



Use the &STACK control statement to stack a single data line in the 
console input stack. Stacked lines may be read by the EXEC, by CMS, or 
by the CMS Editor. The format of the &STACK control statement is: 



SSTACK 



r i r 

IIIZ2I I tokl [tok2 

|LIFO| | HT 
•- J | RT 

L 



[tokn ]]| 






wh er e : 

FIFO specifies that the line is to be stacked in a first in, first 
out sequence. 

LIFO specifies that the line is to be stacked in a last in, first 
out sequence. 

tokl [tok2 ... [tokn]] 

specify the tokens to be stacked. If no tokens are specified, 
a null line is stacked. 



HT 



RT 



stacks the CMS Immediate command HT (halt typing), which is 
executed immediately. All terminal display from the EXEC is 
suppressed until the end of the file or until an RT (resume 
typing) command is read. 

stacks the CMS Immediate command RT (resume typing) , which is 
executed immediately. If terminal display has been suppressed 
as the result of an HT (halt typing) request, display is 
resumed. 



H§§:36 Notes 

1. Lines stacked with the SSTACK control statement are scanned by the 
EXEC interpreter and variable symbols are substituted before the 
line is stacked. To stack one or more unscanned lines, use the 
&BEGSTACK or SBEGSTACK ALL control statement. 

2. You must use the SSTACK control statement when you want to stack a 
null line. 

3. Any CMS Immediate command may be executed in an EXEC, using the 
SSTACK control statement. 

4. A complete discussion of techniques you can use to stack commands 
and data in the console stack is provided in the VM£370: CMS User2.s 
Guide. 
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&TIME 



Use the &TIME control statement to request timing information to be 
displayed at the terminal after each CMS command executes. The format 
of the &TIME control statement is: 



&TIME 



r n 

I OH | 

I Oil I 
|RESET| 
ITYPE | 

L J 



where : 
ON 

OFF 

RESET 
TYPE 



resets the CPU times before every CMS command, and prints the 
timing information on return. If the SCONTROL control 
statement is set to CMS or ALL, the display of the timing 
information is followed by a blank line. 

does not automatically reset the CPU times before every CMS 
command, nor does it print the timing information on return. 

performs an immediate reset of the CPU times. 

displays the current timing information (and resets the CPU 
times) . 



Usage Notes 
1. When timing information is displayed, it is in the format: 
T=x.xx/y.yy hh:mm:ss 
where: 
x. xx 



y.yy 



is the virtual CPU time used since it was last reset in 
the current EXEC file. 

is the total CPU time used since it was last reset in the 
current EXEC file. 



hh:mm:ss is the actual time of day in hours: minutes: seconds. 

2. The CPU times are set to zero before the execution of the first 
statement in the EXEC file, and are set to zero (reset) whenever 
timing information is printed. 
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&TYPE 

Use the &TYPE control statement to display a line of tokens at the 
terminal. The format of the STYPE control statement is: 

| &TYPE | [tokl [tok2 ... [tokn]]] I 



wh er e : 

tokl [tok2... [tokn]] 

specify the tokens to be displayed. All tokens are padded or 
truncated to 8 characters, as necessary. If no tokens are 
specified, a null line is displayed. 

Usage Notes 

1. Lines displayed with the STYPE control statement are scanned by the 
EXEC interpreter and variable symbols are substituted before the 
line is displayed. To display one or more unscanned lines, use the 
&BEGTYPE or &BEGTYPE ALL control statements. 
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Built-in Functions 

You can use the EXEC built-in functions to assign and manipulate 

variable symbols. With the exception of SLITERAL, built-in functions 

may only be used on the right-hand side of an assignment statement, as 
follows: 

&MIX = SCONCAT 81 &2 

Built-in functions may not be combined with arithmetic expressions. 

Each of the built-in functions: &CONCAT, &DATATYPE, &LENGTH, 
SLITERAL, and &SUBSTR, is described separately. 

&CONCAT 

Use the SCONCAT function to concatenate two or more tokens and assign 
the result to a variable symbol. The format of the SCONCAT function is: 



r- 

| &variable = &CONCAT tokl [tok2 ... [tokn]] 

i , , , _ _._ . 



where : 

&variable is the variable symbol whose value is determined by the 
SCONCAT function. 

tokl [ tok2.. .[tokn]] 

specifies the tokens that are to be concatenated into a 
single token, for example: 

&A = ** 



&B = &CONCAT XX &A 45 
&TYPE SB 

results in the printed line: 

XX**45 

Usage Notes 

1. If the concatenated token is longer than 8 characters, the data is 
left justified and truncated on the right. 
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&DATATYPE 

Use the SDATATYPE function to determine whether the value of the 
specified token is alphabetic or numeric data. The format of the 
&DATATYPE function is: 



| Svariable = SDATATYPE token I 

i , . i 



where : 

&variable is the variable symbol whose value is determined by the 
&DATATYPE function. 

token specifies the target token that is to be examined for 
alphabetic or numeric data. The result of the &DATATYPE 
function has the value NUM or CHAR, depending on the data 
type of the specified token. For example, 

&CHECK = SDATATYPE ABC 
&TYPE &CHECK 

results in the display: 

CHAR 



&LENGTH 

Use the SLENGTH function to determine the number of characters in a 
token. The format of the SLENGTH function is: 



| Svariable = SLENGTH token I 

i , , 1 



wh e r e : 

| Svariable is the variable symbol whoe value is determined by the 
| SLENGTH function. 

| token specifies the target token that is to be examined for 
I nonblank characters. The result of the SLENGTH function is 

the number of nonblank characters in the specified token. 

For example, 

SLEN = SLENGTH ALPHA 
STYPE SLEN 

results in the display 

5 
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&LITEEAL 

Use the 8LITERAL function to inhibit variable substitution on the 
specified token. The SLITERAL function may appear in any EXEC control 
statement, as follows: 



| [...] &LITERAL token[ ... ] 

I , : 



w her e : 

j token specifies the token whose literal value is to be used without 
| substitution. For example: 

&X = ** 

STYPE &LITERAL SX EQUALS SX 

results in the printed line: 

&X EQUALS ** 



&SUBSTR 

Use the &SUBSTR function to extract a character string from a specified 
token and to assign the substring to a variable symbol. The format of 
the SSUBSTR function is: 



| &variable = &SUBSTR token i [j] 



where: 



Svariable is the variable symbol whose value is determined by the 
SSUBSTR function. 

token is the token from which the character string is to be 
extracted. 

i specifies the character position in the token of the first 

character to be used in the substring. 

j specifies the number of characters in th string. If 

omitted, the remainder of the token is used. 

1. The values of i and j (if given) must be positive integers. For 
example: 

SA = SSUBSTR ABCDE 2 3 
STYPE SA 

results in the printed line: 

BCD 
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Special Variables 



Special variables are variable symbols that are assigned values by the 
EXEC interpreter, and which you can test or display in your EXEC 
procedures. In some cases, you may assign your own values to EXEC 
special variables; these cases are noted in the variable descriptions. 



&n 

The &n special variable represents the numeric variables &1 through 
&30. When an EXEC is invoked, the numeric variables from 61 through &30 
are initialized according to the arguments that are passed to the EXEC 
file (if any) . 

The numeric variables can be reset by either an SARGS or &READ ARGS 
control statement; when fewer than 30 arguments are set or reset, the 
remainder of the &n variables are set to blanks. A particular argument 
can be set to blanks by assigning it a percent sign (%) when invoking 
the EXEC procedure, in an &ARGS control statement, or in an &READ ARGS 
control statement. 

You may set the values of specific arguments using assignment 
statements. Any value of n, however, that is greater than 30 or less 
than is rejected by the EXEC interpreter. 



&* and &$ 

These variables can be used to perform a collective test on all of the 

arguments passed to the EXEC procedure. &* and &$ may only be used in 

the &IF and &LOOP control statements, and are described under the 
description of the &IF control statement. 

You may not assign values to the special variables &* and &$. 



&0 

The &0 special variable contains the filename of the EXEC file. You may 
test and manipulate this variable. 



I &DISKx 

You can use the SDISKx special variable to determine whether a disk is 
an OS, DOS or CMS disk, x represents the mode letter at which the disk 
is accessed. For example, if you access an OS disk with a mode letter 
of C, then the special variable &DISKC has a value of OS. The possible 
values for the &DISKX special variable are OS (for an OS disk) , DOS (for 
a DOS disk), CMS (for a CMS disk), and NA (when the disk is not 
accessed) . 

You may set or change the values of an &DISKX special variable; if 
you do so, however, you will no longer be able to test the status of the 
disk at mode x. 

Section 5. EXEC Control Statements 299 



EXEC Special Variables 

I &DISK* 

| The SDISK* special variable contains the 1-character mode letter of the 

I first read/write disk in the CMS search order. If you have no 

| read/write disks accessed, this special variable contains the value 

| NONE. 

| You may assign a value to the &DISK* special variable for your own 

j use; if you do so, however, you will not be able to use it to obtain the 

j filemode letter of a read/write disk. 



I &DISK? 

j You can use the &DISK? special variable in an EXEC to determine which 

j read/write disk that you have accessed has the most space on it. If you 

| have no read/write disks accessed, &DISK? contains the value NONE. 

j You may assign a value to the &DISK? special variable for your own 

| use; if you do so, however, you will no longer be able to locate the 

| read/write disk with the most space. 



I &DOS 

| The SDOS special variable contains one of the two character values ON or 

J OFF, depending on whether the CMS/DOS environment is active. If you 

| have issued the command 

S set dos on 

| then the SDOS special variable contains the value ON. 

I You may set or change the value of the &DOS special variable for your 

| own use; if you do so, however, you will not be able to test whether the 

j CMS/DOS environment is active. 



&EXEC 

The 8EXEC special variable is the filename of the EXEC file. You cannot 
set this variable explicitly but you can examine and test it. 



&GLOBAL 

| The SGLOBAL special variable contains the recursion level of the EXEC 

| currently executing. Since the EXEC interpreter can handle up to 19 

| levels of recursion, the value of &GLOBAL ranges from 1 to 19. You 

| cannot set this variable explicitly, but you can examine and test it. 
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&GLOBALn 

The &GLOBALn special variable represents the variables &GLOBAL0 through 
&GL0BAL9. You can set these variables only to integral numeric values. 
They are all initially set to 1. Unlike other EXEC variables, these can 
be used to communicate between different recursion levels of the EXEC 
interpreter. 



&INDEX 

The 8INDEX special variable contains the number of arguments passed to 
the EXEC procedure. Since up to 30 arguments can be passed to an EXEC 
procedure, the value of &INDEX can range from through 30. 

Although you can not set this variable explicitly, it is reset by an 
&ARGS or &READ ARGS control statement. &INDEX can be examined to 
determine the number of active arguments in the EXEC procedure. 



&L1NENUM 

The 8LINENUM special variable contains the current line number in the 
EXEC file. You cannot explicitly set this variable but you can examine 
and test it. 



&READFLAG 

The 6READFLAG special variable contains one of the two literal values 
CONSOLE or STACK. If there are stacked lines in the terminal input 
buffer (console stack) SREADFLAG contains the value STACK and the next 
read request results in a line being read from the stack. If not, then 
the next read request results in a physical read to the terminal, and 
the value of &READFLAG is CONSOLE. You cannot explicitly set this 
variable but you can examine and test it. 



&RETCODE 

The 8RETC0DE special variable contains the return code from the most 
recently executed CMS command. &RETCODE can contain only integral 
numeric values (positive or negative) , and is set after each CMS command 
is executed. You can examine, test, and change this variable but 
changing it is not recommended. 



&TYPEFLAG 

The &TYPEFLAG special variable contains one of the two literal values: 
RT (resume typing) or HT (halt typing) . It contains the value HT when 
terminal display has been suppressed by the Immediate Command HT. It 
contains the value RT when the terminal is displaying output. You 
cannot explicitly set this variable, but you can examine and test it. 
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Section 6. CMS Macro Instructions 



This section describes the formats of the CMS assembler language macros, 
which you can use when you write assembler language programs to execute 
in the CMS environment. To assemble a program using any of these 
macros, you must issue the GLOBAL command specifying CMSLIB MACLIB, 
which is the macro library (located on the system disk) which contains 
CMS macros. 

For functional descriptions and usage examples of the CMS macros, see 
the VM/370: CMS User^s Guide. 

Coding conventions for CMS macros are the same as those for all 
assembler language macros. The macro format descriptions show optional 
operands in the format 

[ , operand] 

indicating that if you are going to use this operand, it must be 
preceded by a comma (unless it is the first operand coded) . If a macro 
statement overflows to a second line, you must use a continuation 
character in column 72. No blanks may appear between operands. 
Incorrect coding of any macro results in assembler errors and MNOTEs. 

Where applicable, the end of a macro description contains a list of 
the possible error conditions that may occur during the execution of the 
macro, and the associated return codes. These return codes are always 
placed in register 15. The macros that produce these return codes have 
ERROR= operands, that allow you to specify the address of an error 
handling routine, so that you can check for particular errors during 
macro processing. If an error occurs during macro processing and no 
error address is provided, execution continues at the next seguential 
instruction following the macro. 
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COMPSWT 



Use the COMPSWT macro to turn the compiler switch (COMPSWT) flag on or 
off. The COMPSWT flag is in the OSSFLAGS byte of the nucleus constant 
area (NUCON) . The format of the COMPSWT macro is: 



| [label] | COMPSWT | 



X on s 



where : 

label 

ON 



is an optional statement label. 

turns the COMPSWT flag on. When this flag is on, any program 

called by a LINK, LOAD, XCTL, or ATTACH macro must be a 

nonrelocatable module in a file with a filetype of MODULE; it is 
loaded via the CMS LOADMOD command. 



OFF turns the COMPSWT flag off. When this flag is off, any program 
called by a LINK, LOAD, XCTL, or ATTACH macro must be a 
relocatable object module residing in a file with a filetype of 
TEXT or TXTLIB; it is loaded via the CMS INCLUDE command. 



FSCB 



Use the FSCB macro to create a file system control block (FSCB) for a 
CMS input or output disk file. The format of the FSCB macro is: 

, . — . , 

| [label] | FSCB | [fileid] [ ,RECFM=format ] [ ,BUFFER=buffer ] | 

| | | [ ,BSIZE=size ] [ ,RECNO=n umber] [ ,NOREC=numrec] | 

i , — ; , 1 



where : 

label 

fileid 



is an optional statement label. 

specifies the CMS file identifier, which must be enclosed 
in quotation marks and separated by blanks ('filename 
filetype filemode*) . If filemode is omitted, A1 is 
assumed. 



RECFM=format 



BUFFER=buffer 



indicates whether the records are fixed- (F) or variable- 
(V) length format. The default is F. 

specifies the address of an I/O buffer, from which 
records are to be read or written. 



BSIZE= : size 



RECNO=number 



NOREC-numrec 



specifies the number of bytes to be read or written for 
each read or write request. 

specifies the record number of the next record to be 
accessed, relative to the beginning of the file, record 
1. The default is 0, which indicates that records are to 
be accessed sequentially. 

specifies the number of records to be read in the next 
read operation. The default is 1. 
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H§S3® Notes 

1. The options RECFM, BUFFER, BSIZE, RECNO, 
specified as self-defining terms. 



FSCB, FSCBD Macros 



and NOREC must all be 



2. You can use the same FSCB to reference several different files; you 
can override the fileid, or any of the options, on the FSOPEN, 
FSWRITE, or FSREAD macros when you reference a file via its FSCB. 

3. You can use multiple FSCBs to reference the same file, for example, 
if you wanted one FSCB for writing and a different FSCB for reading 
the file. Keep in mind, however, that the file characteristics are 
inherent to the file, and not to the FSCB. If you establish a read 
or write pointer using the RECNO option in one FSCB, that pointer 
remains unchanged unless you specify the RECNO option again on the 
same or any other FSCB for that file. 



I FSCBD 



I Use the FSCBD macro to generate a DSECT for the file system control 
| block (FSCB) . The format of the FSCBD macro is: 



, r „ 

| | [label] | FSCBD | 



I label 



is an optional statement label. The first statement 
FSCBD macro expansion is labeled FSCBD. 



in the 



I Usage Notes 

| 1. You can use the labels established in the FSCB DSECT to modify the 

| fields in an FSCB for a particular file. An FSCB is created 

I explicitly by the FSCB macro, and implicitly by the FSREAD, 
| FSWRITE, and FSOPEN macros. 

| 2. The FSCB macro expands as follows: 





FSCBD 




FSCBD 


DSECT 




FSCBCOMM 


DS 


CL8 


FSCBFN 


DS 


CL8 


FSCBFT 


DS 


CL8 


FSCBFM 


DS 


CL2 


FSCBITNO 


DS 


H 


FSCBBUFF 


DS 


A 


FSCBSIZE 


DS 


F 


FSCBFV 


DS 


CL2 


FSCBNOIT 


DS 


H 


FSCBNORD 


DS 


A 



Command 

Filename 

Filetype 

Filemode 

Relative record (item) number 

Address of read/write buffer 

Length of buffer 

Record format (F or V) 

Number of records to be read/written 

Number of -i'suULdTi actually read 



bytes 
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FSCLOSE 

Use the FSCLOSE macro to close an open file and save its current status 
on disk. The format of the FSCLOSE macro is: 

| [label] | FSCLOSE | / fileid[ , FSCB=fscb ] \ [ ,ERROR=erraddr ] | 



/ fileid[,FSCB=fscb] )[, 
\ FSCB=fscb J 



| | | ( FSCB=fscb J | 

wh er e : 

label is an optional statement label. 

fileid specifies the CMS file identifier. It may be: 

■ fn ft fro 1 fileid enclosed in quotation marks and separated 
by blanks. If fm is omitted, A1 is assumed. 

(reg) a register other than or 1 containing the 
address of the fileid (18 characters). 

FSCB-fscb specifies the address of an FSCB. It may be: 

label the label on the FSCB macro. 

(reg) a register containing the address of an FSCB. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

n§^ae Notes 

1. Although CMS routines close files when a command or program 
completes execution, you can use the FSCLOSE macro when you are 
executing a program from within an EXEC, or when you are going to 
read and write records in the same file. 

2. If you specify both fileid and FSCB, the fileid is used to fill in 
the FSCB. 

IEE2E Conditions 

If an error occurs, register 15 contains the following error code: 

Q2^§ M§anil9 
6 File not open 
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FSERASE 

Use the FSERASE macro to delete a CMS disk file. The format of the 
FSERASE macro is: 

| [label] | FSERASE | ( fileid[ , FSCB=f scb] \{ ,ERROR=erraddr ] | 

I | | | FSCB=fscb J | 

i™ : , : __ , i 

wh e r e : 

label is an optional statement label. 

fileid specifies the CMS file identifier. It may be: 

1 f n ft fm 1 fileid enclosed in quotation marks and separated 
by blanks. If fm is omitted, A1 is assumed. 

(reg) a register other than or 1 containing the 
address of the fileid (18 characters) . 

FSCB=fscb specifies the address of an FSCB. It may be: 

label the label of an FSCB macro. 

(reg) a register containing the address of an FSCB. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error occurs. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

M§§ae Notes 

1. On return from the FSERASE macro, register 1 points to a parameter 
list. The second, third, and fourth words of the list contain the 
filename, filetype, and filemode of the file. 

2. If fileid and FSCB= are both coded, the fileid is used to fill in 
the FSCB. 

Error Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

24 Parameter list error 

28 File not found 

36 Disk not accessed 
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FSOPEN 

Use the FSOPEN macro to ready a file for either input or output. The 
format of the FSOPEN macro is: 

i ■ — ■ ■ ; 1 

| [label] | FSOPEN | J fileid [,FSCB=fscb] 1 [ ,ERROR=erraddr ][ , opt ions] | 
I | | \ FSCB=fscb j I 

w her e : 

label is an optional statement label. 

fileid specifies the CMS file identifier. It may be: 

»fn ft fm» the fileid enclosed in quotation marks and 
separated by blanks. If fm is omitted, A1 is 
assumed. 

(reg) a register other than or 1 containing the 
address of the fileid (18 characters) . 

FSCB=fscb specifies the address of an FSCB. It may be: 

label the label on an FSCB macro. 

(reg) a register containing the address of an FSCB. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

Options 

You can specify any of the following FSCB macro options on the FSOPEN 
macro: 

BUFFER= buffer 

RECNO=number 

BSIZE=size 

RECFM=format 

NOREC=numrec 

These options may be specified either as self-defining terms or in 
register notation. 

When you use any of these options, the associated field in the 
FSCB is modified. 

Usage Notes 

1. On return from the FSOPEN macro, register 1 points to the FSCB for 
the file. If no FSCB exists, one is created in the FSOPEN macro 
expansion. 

2. If you code both fileid and FSCB=, the fileid is used to fill in 
the FSCB. 

3. You can use the FSOPEN macro to verify the existence of a file to 
be opened for reading or writing and to create an FSCB for it. 
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Error Conditions 



If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 
20 Invalid file identifier 
28 File does not exist 



FSREAD 

Use the FSREAD lacro to read a record from a disk file into an I/O 
buffer. The format of the FSREAD macro is: 



| [label] | FSREAD | 
I I I 



( fileid[ , FSCB=fscb] 1 [ ,ERROR=erraddr ] [, options] | 
( FSCB=fscb J | 






where: 

label is an optional statement label. 

fileid specifies the CMS file identifier. It may be: 

1 fn ft fm» the fileid enclosed in guotation marks and 
separated by blanks. If fm is omitted, A1 is 
assumed. 

(reg) a register other than or 1 containing the 
address of the fileid (18 characters) . 

FSCB=fscb specifies the address of an FSCB. It may be: 

label the label of an FSCB macro. 

(reg) a register containing the address of an FSCB. 

ERROH=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERR0R= is not coded and an error 
occurs, control returns to the next seguential instruction in 
the calling program, as it does if no error occurs. 

Options 

You can specify any of the following FSCB macro options on the FSREAD 
macro: 

BUFFER= buffer 
NOREC=numrec 
BSIZE=size 
RECNO=number 

These options may be specified as self-defining terms or in register 
notation. 

When you use any of these options, the associated field in the 
FSCB is modified. 
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U§<*9§ Notes 

1. If an FSCB macro has not been coded for a file (and the FSCB= 
operand is not coded) , you must specify the BUFFER- and BSIZE= 
options. 

2. On return from the FSREAD macro, register 1 points to the FSCB for 
the file. If no FSCB exists, one is created following the FSREAD 
macro instruction. 

3. If you specify both fileid and FSCB=, the fileid is used to fill in 
the FSCB. 

4. Register contains, after the read operation is complete, the 
number of bytes actually read. This information is also contained 
in the FSCBNORD field of the FSCB. 

5. To read records sequentially beginning with a particular record 
number, use the RECNO option to specify the first record to be 
read. On the next FSREAD instruction, use RECNO=0 so that reading 
continues sequentially following the first record read. 

l££2I Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

£2£e Me§SiS9 

1 File not found 

2 Invalid buffer address 

3 Permanent I/O error 

5 Number of records is less than or equal to zero, or greater 
than 32,768 

7 Invalid record format (only checked when the file is first 

opened for reading) 

8 Incorrect length 

9 File open for output 

11 Number of records greater than 1 for variable- length file 

12 End-of-file 

13 Variable-length file has invalid displacement in active file 

table 

14 Invalid character in filename 

15 Invalid character in filetype 
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FSSTATE 

Use the FSSTATE macro to determine whether a particular file exists. 
The format of the FSSTATE macro is: 

| [label] | FSSTATE | £ fileid [,FSCB=fscb] } [ ,ERROR=erraddr ] 

I | | { FSCB=fscb } | 

I : I 

wh ere : 

label is an optional statement label. 

fileid specifies the CMS file identifier. It may be: 

• f n ft f m* the fileid enclosed in quotation marks and 
separated by blanks. If fm is omitted, A1 is 
assumed. 

(reg) a register other than or 1 containing the 
address of the fileid (18 characters). 

FSCB=fscb specifies the address of an FSCB. It may be: 

label the label on an FSCB macro. 

(reg) a register containing the address of an FSCB. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

1. If the specified file exists, register 15 contains a return 
code. 

2. When the FSSTATE macro completes execution, register 1 contains the 
address of the file status table (FST) for the specified file. 

Error Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

20 Invalid character in fileid 

24 Invalid filemode 

28 File not found 

36 Disk not accessed 
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FSWRITE 



Use the FSWRITE macro to write a record from an I/O buffer to a CMS disk 
file. The format of the FSWRITE macro is: 



| [label] | FSWRITE | / fileid[ , FSCB=f scb ] ) [ ,ERROR=erraddr ][ , options] | 
i | | \ FSCB=fscb J | 



where : 

label is an optional statement label. 

fileid specifies the CMS file identifier. It may be: 

* f n ft fm» the fileid enclosed in quotation marks and 
separated by blanks. If fm is omitted, A1 is 
assumed. 

(reg) a register other than or 1 containing the 
address of the fileid (18 characters) . 

FSCB=fscb specifies the address of an FSCB. It may be: 

label the label on an FSCB macro. 

(reg) a register containing the address of an FSCB. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

Options 

You can specify any of the following FSCB macro options on the 
FSWRITE macro: 

BUFFER=buffer 

RECNO=number 

BSIZE=size 

NOREC=numrec 

RECFM=format 

These options may be specified as either self-defining terms or in 
register notation. 

When you use any of these options, the associated field in the 
FSCB for the file is filled in or modified. 

Osage Notes 

1. If an FSCB macro has not been coded for a file (and the FSCB= 
operand is not coded on the FSWRITE macro) , you must specify the 
BUFFER= and BSIZE= options. For the filemode, you must specify 
both a letter and a number. If the file is a variable-length file, 
you must also specify the RECFM option. 

2. On return from the FSWRITE macro, register 1 contains the address 
of the FSCB for the file. If no FSCB exists, one is created 
following the FSWRITE macro instruction. 
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3. If you specify both fileid and FSCB=, the fileid is used to fill in 
the FSCB. 

4. If the RECNO option is specified (either on the FSWRITE macro or in 
the FSCB) , that specified record is written. Otherwise, the next 
sequential record is written. For new files, writing begins with 
record 1 ; for existing files, writing begins with the first record 
following the end of the file. 

5. To write records sequentially beginning with a particular record 
number, use the RECNO option to specify the first record to be 
written. On the next FSWRITE instruction, use RECNO=0 so that 
writing continues sequentially, following the first record 
written. 

6. To write blocked records (valid for fixed-length files only), use 
the BSIZE and NOREC options to specify the blocksize and number of 
records per block, respectively. For example, to write 80-byte 
records into 800-byte blocks, you should specify BSIZE=800 and 
NOREC=10. The buffer you use must be at least 800 bytes long. 

l££2I Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

2 Invalid buffer address 

4 First character of filemode is illegal 

5 Second character of filemode is illegal 

6 Item number too large 

7 Attempt to skip over unwritten variable-length item 

8 Buffer size not specified 

9 File open for input 

10 Maximum number files reached 

11 Record format not F or V 

12 Attempt to write on read-only disk 

13 Disk is full 

14 Number of bytes to be written is not integrally divisible 

by the number of records to be written 

15 Length of fixed- length item not the same as previous 

item 

16 Record format specified not the same as file 

17 Variable- length item greater than 65K bytes 

18 Number of records greater than 1 for variable-length file 

19 Maximum number of data blocks per file reached (16060) 

20 Invalid character detected in filename 

21 Invalid character detected in filetype 

22 Virtual storage capacity exceeded 

25 Insufficient free storage available for file directory 
buffers 
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HNDEXT 

Use the HNDEXT macro to trap external interrupts and pass control to an 
internal routine for processing. External interrupts are caused, in a 
virtual machine, by the CP EXTERNAL command. The format of the HNDEXT 
macro is: 

| [label] | HNDEXT | ( SET, address 1 I 

II I I CLR J | 

L. , „. , 1 

where; 

label is an optional statement label. 

SET specifies that you want to trap external interrupts. 

address specifies the address in your program of the routine to be 
given control when an external interrupt occurs. 

CLR specifies that you no longer want to trap external 
interrupts. 

1. External interrupts (other than timer interrupts) normally place 
your virtual machine in the debug environment. 

2. When your interrupt handling routine is given control, all virtual 
| interrupts, except multiplexor, are disabled. If you are using the 
j CMS blip function, all blips are stacked. 

3. You are responsible for providing proper entry and exit linkage for 
your interrupt handling routine. When your routine receives 
control, register 1 points to a save area in the format: 



Label 
GRS~ 


Displacement 
Dec Hex 



FRS 


64 


40 


PSH 


96 


60 


UAREA 


108 


68 


END 


180 


B4 



Register 13 points to the user save area at label UAREA. 

Register 15 contains the entry point address of your routine; it 
must return control to the address in register 14. 
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HNDINT 



Use the HNDINT macro to trap interrupts for a specified I/O device. The 
format of the HNDINT macro is: 



[label] | HNDINT 



SET, 



', (dev1,jaddr) ,cuu,J ASAP) )[ r (dev2.. .) .. . 
\ J I WAIT J 

CLEAR, (dev1)[ , (dev2)[... ]] 

[ ,ERROR=erraddr ] 



where : 

label is an optional statement label. 

SET specifies that you want to trap interrupts for the specified 
device. 

dev specifies a 4-character symbolic name for the device whose 
interrupts are to be trapped. 

addr specifies the address in your program of the routine to be 
given control when the interrupt occurs. An address of 
indicates that interrupts for the device are to be ignored. 

cuu specifies the virtual device address, in hexadecimal, of the 
device whose interrupts are to be trapped. 

ASAP specifies that the routine at addr is to be given control as 
soon as the interrupt occurs. 

WAIT specifies that the routine at addr is to be given control 
after the WAITD macro is issued for the device. 

CLR specifies that you no longer want to trap interrupts for the 
specified device. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next seguential instruction in 
the calling program, as it does if no error occurs. 

Usage Notes 

1. You can define interrupt handling routines for more than one device 
in a single HNDINT macro. The argument list for each device must be 
enclosed in parentheses and separated from the next list by a 
comma. 

2. If you specify WAIT, then the routine at the specified address in 
your program receives control when a WAITD macro that specifies the 
same symbolic device name is issued. If the WAITD macro has 
already been issued for the device when the interrupt occurs, then 
the routine at the specified address receives control immediately. 

3. You are responsible for establishing proper entry and exit linkage 
for your interrupt handling routine. When your routine receives 
control, the significant registers contain: 
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Registers Contents 
"0-1 I/O old PSH 
2-3 Channel status word (CSW) 

4 Address of interrupting device 

14 Return address 

15 Entry point address 

Your routine must return control to the address in register 14, and 
indicate, via register 15, whether processing is complete. A in 
register 15 means that you are through handling the interrupt; any 
nonzero return code indicates that you expect another interrupt. 

4. The interrupt handling routine that you code should not perform any 
I/O operations. When it is given control, all I/O interrupts and 
external interrupts are disabled. 

Il£2£ Conditions 

If an error occurs, register 15 contains a 1, indicating that either the 
device address (cuu) or the address of the interrupt handling routine 
(addr) is invalid. 



HNDSVC 

Use the HNDSVC macro to trap interrupts caused by specific supervisor 
call (SVC) instructions. The format of the HNDSVC macro is: 

| [label] | HNDSVC | j SET, (svcnum, address) [, (svcnum, address) ... ] \ | 

| | | \ CLEAR, svcnum[ , svcnum. .. ] J | 

III I 

| | | [ ,ERROR=erraddr ] I 

w h er e : 

label is an optional statement label. 

SET specifies that you want to trap SVCs of the specified 
number (s) . 

svcnum specifies the number of the SVC you want to trap. SVC numbers 
through 200 and 206 through 255 are valid. 

address specifies the address of the routine in your program that 
should receive control whenever the specified SVC is issued. 

CLR specifies that you no longer want to trap the specified 
SVC(s). 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next seguential instruction in 
the calling program, as it does if no error occurs. 
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Usage Notes 

1. You are responsible for providing the proper entry and exit linkage 
for your SVC-handling routine. When your program receives control, 
the following registers contain: 

JteSister Contents 

12 Address of your SVC-handling routine 

13 Address of an 18-fullword save area (for your use) 

14 Return address 

Your routine must return control to the address in register 14. 

l££2£ Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

1 Invalid SVC number or address 

2 SVC number set replaced previously set number 

3 SVC number cleared was not set 



LINEDIT 



Use the LIMEDIT macro to convert decimal values into EBCDIC or 
hexadecimal and to display the results at your terminal. The format of 
the LINEDIT macro is: 



[label] | LINEDIT 



r i 

I # TEXT=» message-text 1 | 
| ,TEXTA=address | 

L J 



|,DOT=/YES) | 



|,COMP=(YES\ | 



\N0 / | | \N0 

L J L 

[ , SUB= (substitution-list) ] 



I 



|,DISP= [ TYPE 
NONE 
SIO 
PRINT 

| / CPCOMM 

^ERRMSG 



[,MAXSUBS=number] 



[ ,BUFFA=address] 

UMF= (I 

I U 

| ( (E, address) 

L 

r t 

|,RENT=(YES\ | 



\»0 / 



The LINEDIT macro operands are listed below, briefly. For detailed 
formats, descriptions, and examples, refer to the appropriate heading 
following "LINEDIT Macro Operands." 

TEXT= I message-text • 

specifies the text of the message to be edited. 
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TEXTA=ad dress 

specifies the address of the message text. It may be: 

label the symbolic address of the message text, 
(reg) a register containing the address of the message 
text. 

DOT specifies whether a period is to be placed at the end of the 
line. 

COMP specifies whether multiple blanks are to be removed from the 
line. 

SUB specifies a substitution list describing the conversions to be 
performed on the line. 

DISP specifies how the edited line is to be used. When DISP is not 
coded, the message text is displayed at the terminal. 

BUFFA specifies the address of the buffer in which the line is to be 
copied. 

MF specifies the macro format. 

MAXSUBS specifies the maximum number of substitutions (MAXSUBS is used 
with the list form of the macro) . 

RENT specifies whether reentrant code must be generated. 

Msacje Notes 

1. You should never use registers 1 or 15 as address registers when 
you code the LINEDIT macro; these registers are used by the macro. 

2. When message text for the LINEDIT macro contains two or more 
consecutive periods, it indicates that a substitution is to be 
performed on that portion of the message. The number of periods 
you code indicates the number of characters that you want to appear 
as output. To indicate what values are to replace the periods, code 
a substitution list using the SUB operand. 

3. When you use the standard (default) form of the LINEDIT macro, 
reentrant code is produced, except when you specify more than one 
substitution list, or when you use register notation to indicate an 
address on the TEXTA or BUFFA operands. When any of these 
conditions occur, an MNOTE message is produced, indicating that the 
code is not reentrant. 

If you do not care whether the code is reentrant, you can 
specify the RENT=NO operand to suppress the MNOTE message. 
Otherwise, you can use the list and execute forms of the macro to 
write reentrant code (see "MF Operand") . 



LINEDIT Macro Operands 

TEXT Operand 

Use the TEXT operand to specify the exact text of the message on the 
macro instruction. The message text must appear within single guotation 
marks, as follows: 
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TEXT='message text' 

If you want a single quotation mark to appear within the actual message 
text, you must code two of them. 

Text specified on the LINEDIT macro is edited so that multiple blanks 
appear as only a single blank, and a period is placed at the end of the 
line, for example: 

LINEDIT TEXT=»IT ISN"T READY* 

results in the display: 

IT ISN'T READY. 

TEXTA Operand 

Use the TEXTA operand when you want to display a line that is contained 
in a buffer. You may specify either a symbolic address or use register 
notation, as follows: 

TEXTA=/label\ 
I (reg) / 

In either case, the first byte at the address specified must contain the 
length of the message text, for example: 

LINEDIT TEXTA=MESSAGE 



MESSAGE DC X'16» 

DC CL22»THIS IS A LINE OF TEXT* 

If you use register notation with either the standard or list forms 
of the macro, the code generated is not reentrant. To suppress the MNOTE 
that informs you that code is not reentrant, use the RENT=NO operand. 

DOT Operand 

Use the DOT operand when you do not want a period placed at the end of 
the message text. The format of the DOT operand is: 

DOT=/YES\ 
\I0 I 

For example, if you code 

LINEDIT TEXT= , HI! l ,DOT=NO 
the line is displayed as 

HI! 

COMP Operand 

Use the COMP operand when you want to display multiple blanks within 
your message text. The format of the COMP operand is: 



COMP = 



/YES \ 
(NO J 
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For example, if you code 

LINEDIT TEXT=»TOTAL 5«,C0MP=N0 
The line is displayed as 
TOTAL 5. 

SUB Operand 

Use the SUB operand to specify the type of substitution to be performed 
on those portions of the message that contain periods. For each set of 
periods, you must specify the type of substitution and the value to be 
substituted or its address. The format of the SOB operand is: 

SUB= / HEXf r (reg) ) 
DEC( , expression / 

HE XAJ, address) 
DECA\,(reg) } 

HEX4A ( , address 
CHARA ) r (reg) 
CHAB8A 



, ((, address), /length)) 
tr(reg) / \(reg) / 



Each of the possible substitution pairs are descibed below, followed by 
discussions of length specification and multiple substitution lists. 

HEX, (reg) 

converts the value in the specified register to graphic hexadecimal 
format and substitutes it in the message text. If you code fewer 
than eight consecutive periods in the message text, then leading 
digits are truncated; leading zeros are not suppressed. 

For example, if register 3 contains the value C0031FC8, then the 
macro 

LINEDIT TEXT=»VALUE = . . . • , SUB= (HEX, (3) ) 

results in the display 

VALUE = FC8. 

HEX, expression 

converts the given expression to graphic hexadecimal format and 
substitutes it in the message text. The variable, expression, may 
be a symbolic address or symbol eguate; it is evaluated by means of 
a LOAD ADDRESS (LA) instruction. For example, if your program has a 
label BUFF1, the line 

LINEDIT TEXT=« BUFFER IS LOCATED AT ■ ,SUB= (HEX, BUFF1 ) 

might result in the display: 

BUFFER IS LOCATED AT 0201AC. 

If you code fewer than eight periods in the message text, 
leading digits are truncated:; leading zeros are not suppressed. 
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DEC, (reg) 

converts the value in the specified register into graphic decimal 
format and substitutes it in the message text. Leading zeros are 
suppressed. If the number is negative, a leading minus sign is 
inserted. For example, if register 3 contains the decimal value 
10,345, then the macro 

LINEDIT TEXT=»REG 3 = • , SUB= (DEC, (3) ) 

results in the line 

REG 3 = 10345. 

DEC, expression 

converts the given expression to graphic decimal format and 
substitutes it in the message text. The variable, expression, may 
be a symbolic label in your program or a symbol eguate. For 
example, if your program contains the statement 

VALUE EQO 2003 
then the macro 

LINEDIT TEXT=' VALUE IS • , SUB= (DEC , VALUE+5) 

results in the display: 

VALUE IS 2008. 

HEXA, address 

converts the fullword at the specified address to graphic 
hexadecimal format and substitutes it in the message text. If you 
code fewer than eight periods in the message text, leading digits 
are truncated; leading zeros are not removed. For example, if you 
code 

LINEDIT TEXT=«HEX VALUE IS ' , SUB= (HEX A, CODE) 

then the last five hexadecimal digits of the fullword at the label 
CODE are substituted into the message text. 

HEXA, (reg) 

converts the fullword at the address indicated in the specified 
register into graphic hexadecimal format and substitutes it in the 
message text. For example, if you code 

LINEDIT TEXT=' REGISTER 5 -> • , SUB= (HEXA , (5) ) 

then the last six hexadecimal digits of the fullword whose address 
is in register 5 are substituted in the message text. 

If you code fewer than eight digits, leading digits are 
truncated; leading zeros are not suppressed. 

DECA, address 

converts the fullword at the specified address to graphic decimal 
format. Leading zeros are suppressed; if the number is negative, a 
minus sign is inserted. For example, if you code 

LINEDIT TEXT=' COUNT = •, SUB= (DECA , COUNT) 

then the fullword at the location COUNT is converted to graphic 
decimal format and substituted in the message text. 
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DECA, (reg) 

converts the fullword at the address specified in the indicated 
register into graphic decimal format and substitutes it in the 
message text. For example, 

LINEDIT TEXT=«SUM = • ,SUB= (DECA, (3) ) 

causes the value in the fullword whose address is in register 3 to 
be displayed in graphic decimal format. 

HEX4 A, address 

converts the data at the specified address into graphic hexadecimal 
format, and inserts a blank character following every 4 bytes (8 
characters of output) . The data to be converted does not have to 
be on a fullword boundary. 

When you code periods in the message text for substitution, you 
must code sufficient periods to allow for the blanks. Thus to 
display 8 bytes of information (16 hexadecimal digits), you must 
code 17 periods in the message text. 

For example, to display 7 bytes of hexadecimal data beginning at 
the location STOR in your program, you could code: 

LINEDIT TEXT=' STOR: • ,SUB= (HEX4A,ST0R) 

This might result in a display: 

STOR: 0A23F115 78ACFE 

Note that 15 periods were coded in the message text, to allow for 
the blank following the first 4 bytes displayed. 

HEX4A, (reg) 

converts the data at the address indicated in the specified 
register into graphic hexadecimal format and inserts a blank 
character following every 4 bytes displayed (8 characters of 
output) . 

When you code the message text for substitution, you must code 
sufficient periods to allow for the blank characters to be 
inserted. 

For example, the line 

LINEDIT TEXT=»BUFFER: • , SUB= (HEX4A, (6) ) 

results in the display of the first 9 bytes at the address in 
register 6, in the format 

hhhhhhhh hhhhhhhh hh 

CHARA, address 

substitutes the character data at the specified address into the 
message text. For example, 

LINEDIT TEXT=«NAME IS •• ••', SUB= (CHARA , NAME) 

causes the 10 characters at location NAME to be substituted into 
the message text. Multiple blanks are removed. 
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CHARA, (reg) 

substitutes the character data at the address indicated in the 
specified register into the message text. For example, 

LINEDIT TEXT=«CODE IS • , SUB= (CHARA , (7) ) 

the first 4 characters at the address indicated in register 7 are 
substituted in the message line. 

CHAR8A, address 

substitutes the character data at the specified address into the 
message text, and inserts a blank character following each 8 
characters of output. 

When you code the message text, you must code enough periods to 
allow for the blanks that will be substituted. 

This substitution list is convenient for displaying CMS 
parameter lists. For example, to display a fileid in an FSCB, you 
might code 

LINEDIT TEXT=' FILEID IS » , 

SUB= (CHAR8A,OUTFILE+8) 

where OUTFILE is the label on an FSCB macro. If the fileid for 
this file were TEST OUTPUT A1 , then the LINEDIT macro would result 
in the display 

FILEID IS TEST OUTPUT A1 . 

In the final edited line, multiple blanks are reduced to a single 
blank. 

CHAR8A, (reg) 

substitutes the character data at the address indicated in the 
specified register and inserts a blank character following each 
eight characters of output. 

When you code the message text, you must include sufficient 
periods to allow for the blanks. For example. 



LINEDIT TEXT=» PLIST: • , 

SUB=(CHAR8A, (7)) 

results in a display of 4 doublewords of character data, beginning 
at the address indicated in register seven. 

SPECIFYING THE LENGTH FOR LINEDIT MACRO SUBSTITUTION: In all the 
examples shown, the length of the argument being substituted was 
determined by the number of periods in the message text. The number of 
periods indicated the size of the output field, and indirectly 
determined the size of the input data area. 

For hexadecimal and decimal substitutions, the input data is 
truncated on the left. To ensure that a decimal number will never be 
truncated, you can code 10 periods (11 for negative numbers) in the 
message text where it will be substituted. For hexadecimal data, code 8 
periods to ensure that no characters are truncated when a fullword is 
substituted. 

When you are coding substitution lists with the CHARA, CHAR8A, and 
HEX4A options, however, you can specify the length of the input data 
field. You must code the SUB operand as follows: 

SUB= (type, (address, length) ) 
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Both address and length may be specified using register notation. For 
example: 

SUB= (HEX4A, (LOC, (4) )) 

In this example, the characters at location LOC are substituted into the 
message text; the number of characters is determined by the value 
contained in register 4, but it cannot be larger than the number of 
periods coded in the message text. 

You can use this method in the special case where only 1 character is 
to be substituted. Since you must always code at least two periods to 
indicate that substitution is to be performed, you can code two periods 
and specify a length of one, as follows: 

LINEDIT TEXT='ILLEGAL MODE LETTER . . • ,SUB= (CHARA, (PLIST+24, 1 ) ) 

SPECIFYING MULTIPLE SUBSTITUTION LISTS: When you want to make several 
substitutions in the same line, you must enter a substitution list for 
each set of periods in the message text. For example, 

LINEDIT TEXT=« VALUES ARE and ', 

SUE= (DEC, (3) , HEXA,LOC) 

might generate a line as follows: 

VALUES ARE -45 AND FFE3C2. 

You should remember, however, that if you are using the standard form 
of the macro, and you want to perform more than one substitution in a 
single line, the LINEDIT macro will not generate reentrant code. If you 
code RENT=NO on the macro line, then you will not receive the MNOTE 
message indicating that the code is non-reentrant. If you want reentrant 
code, you must use the list and execute forms of the macro. 

DISP Operand 

Use the DISP operand to specify the output disposition of the edited 
line. The format of the DISP operand is: 

I) ISP = / TYPE 
NONE 
PRINT 
iCPCOMM 
ERRMSG 
SIO 

wh er e :: 

DISP=TYPE 

specifies that the message is to be displayed on the terminal. 
This is the default disposition. 

DISP=NONE 

specifies that no output occurs. This option is useful with the 
BUFFA operand. 

DISP=PRINT 
| specifies that the line is to be printed on the virtual printer. 
J The first character of the line is interpreted as a carriage 
I control character. (See the discussion of the PRINTL macro for a 
| list of valid ASA control characters.) 
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DISP=CPCOMM 

specifies that the line is to be passed to CP to be executed as a 
CP command. For example, 

LINEDIT TEXT=»QUERY USERS ' ,DOT=NO 

results in the CP command line being passed to CP and executed. 

DISP=ERRMSG 

specifies that the line is to be checked to see if it gualifies for 
error message editing. If it does, it is displayed as an error 
message rather than as a regular line. 

The standard format of VM/370 error messages is: 

xxxmmmnnns 

where xxxmmm is the name of the module issuing the message, nnn is 
the message number, and s is the severity code. You can code 
whatever you want for the first 9 characters of the code when you 
write error messages for your programs, but the tenth character 
must specify one of the following VM/370 message types: 

£2<1§ H§ssage Type 

I Information 

w Warning 

E Error 

Then, the line is displayed in accordance with the CP EMSG 
setting. If EMSG is set to ON, then the entire message is 
displayed; if EMSG is set to TEXT, then only the message portion is 
displayed; if EMSG is set to CODE, then only the 10-character code 
is displayed. 

DISP=SIO 

specifies that the message is to be displayed, at the terminal, 
using SIO instead of TYPLIN, which is normally used. This option 
is used by CMS routines in cases where free storage pointers may be 
destroyed. Since lines are not stacked in the console buffer, no 
CONWAIT function is performed. 

BUFFA Operand 

Use the BUFFA operand to specify the address of a buffer into which the 
edited message is to be written. The message is copied into the 
indicated buffer, as well as being used as specified in the DISP 
operand. The format of the BUFFA operand is: 



BUFFA= 



(address ) 
l,(reg) J 



When the text is copied into the buffer, the length of the message 
text is inserted into the first byte of the buffer, and the remainder of 
the text is inserted in subseguent bytes. 

If you use register notation to indicate the buffer address, the code 
generated will not be reentrant. To suppress the MNOTE that informs you 
that code is not reentrant, use the RENT=NO operand. 
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MF Operand 



Use the MF operand to specify the macro format when you want to code 
list and execute forms when you write reentrant programs. The format of 
the MF operand is: 



(E,(addr )) 
10 




(reg) / 



where: 



MF=I (Standard form) 

generates an inline operand list for the LINEDIT macro, and calls 
the routine that displays the message. This is the default. It 
generates reentrant code, except under the following circumstances: 

• When you specify more than one substitution list. 

• When you use register notation with the TEXTA or BUFFA 
operands. 

MF=L (List form) 

generates a parameter list to be filled in when the execute form of 
the macro is used. 

The size of the area reserved depends upon the number of 
substitutions to be made, which you can specify with the MAXSUBS 
operand. For example, 

LINEDIT MF=L,MAXSUBS=5 

reserves space for a parameter list which may hold up to five 
substitution lists. This same list may be used by several LINEDIT 
macros. 

MF= (E, address) (Execute form) 

generates code to fill in the parameter list at the specified 
address, and calls the routine that displays the message text. 

The address specified (either a symbolic address or in register 

notation) indicates the location of the list form of the macro. 

The following example shows how you might use the list and execute 
forms of the LINEDIT macro to write reentrant code: 

WRITETOT LINEDIT TEXT= ■ SUBTOTAL TOTAL ', 

SUB=(DEC, (4) ,DEC, (5) ) ,MF= (E, LINELIST) 



LINELIST LINEDIT MF=L,M AXSUBS=6 

When the execute form of the LINEDIT macro is used, the parameter 
list for the message is built at label LINELIST, where the list 
form of the macro was coded. 

MAXSUBS Operand 

Use the MAXSUBS operand when you code the list form (MF=L) form of the 
LINEDIT macro. The format of the MAXSUBS operand is: 

MAXSUBS=number 
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where number specifies the maximum number of substitutions that will be 
made when the execute form of the macro is used. 

RENT Operand 

Use the RENT operand when you are going to use the standard form of the 
LINEDIT macro and you do not care whether the code that is generated is 
reentrant. The format of the RENT operand is: 



RENT= 



/YES ) 
(NO / 



When RENT=YES (the default) is in effect, the LINEDIT macro expansion 
issues an MNOTE message indicating that nonreentrant code is being 
generated. This occurs when you use the standard form of the macro and 
you specify one of the following: 

• TEXTA= (reg) 

• BUFFA=(reg) 

• More than one substitution pair 

If you do not care whether the code is reentrant, and you do not wish to 
have the MNOTE appear, code RENT=NO. The RENT=NO coding merely 
suppresses the MNOTE statement; it has no effect on the expansion of the 
LINEDIT macro. 



PRINTL 

Use the PRINTL macro to write a line to a virtual printer. The format 
of the PRINTL macro is: 

| [label] | PRINTL | line [, length] [ , ERROR=erraddr ] | 

where : 

label is an optional statement label. 

line specifies the line to be printed.lt may be: 

•linetext' text enclosed in guotation marks, 
lineaddr the symbolic address of the line, 
(reg) a register containing the address of the line. 

length specifies the length of the line to be printed. (See Note 
1.) It may be: 

(reg) a register containing the length. 

n a self-defining term indicating the length. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next seguential instruction in 
the calling program, as it does if no error occurs. 
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Usage Notes 

1. The maximum length allowed is 151 characters on a virtual 3211 or 
133 characters on a virtual 1403. If you do not specify the 
length, it defaults to 133 characters, unless 'linetext* is 
specified. In this case, the length is taken from the length of the 
line text. 

2. The first character of the line is interpreted as a carriage 
control character, which may be either ASA (ANSI) or machine code. 
The valid ASA control characters are: 

Meaning 

Space 1 line before printing 

Space 2 lines before printing 

Space 3 lines before printing 

Suppress space before printing 

Skip to channel 1 

Skip to channel 2 

Skip to channel 3 

Skip to channel 4 

Skip to channel 5 

Skip to channel 6 

Skip to channel 7 

Skip to channel 8 

Skip to channel 9 

Skip to channel 10 

Skip to channel 11 

3. Hex codes X'CI 1 and X^S' are used in both machine code and ASA 
code. CMS recognizes these codes as ASA control characters, not as 
machine control characters. 

4. If the line does not begin with a valid carriage control character, 
the line is printed with a write command to space one line before 
printing (ASA X^O 1 ) . 

J 5. When the macro completes, register 15 may contain a 2 or a 3, 

| indicating that a channel 9 or channel 12 punch was sensed, 

J respectively. you can use these codes to determine whether the end 

| of the page is near (channel 9) , or if the end of the page has been 

| reached (channel 12) . You might want to check for these codes if 

| you want to print particular information at the bottom or at the 

| end of each page being printed. 

J When the channel 9 or channel 12 punch is sensed, the write 

| operation terminates after carriage spacing but before writing the 

| line. If you want to write the line without additional space, you 

| must modify the carriage control character in the buffer to a code 

j that writes without spacing (ASA code + or machine code 01) . 

6. You must issue the CP CLOSE command to close the virtual printer 
file. Issue the CLOSE command either from your program (using an 
SVC 202 instruction or a LINEDIT macro) or from the CMS environment 
after your program completes execution. The printer is 
automatically closed when you log off or when you use the CMS PRINT 
command. 



Character 



Hex Code 
40 
F0 


- 


60 


+ 


4E 


1 


F1 


2 


F2 


3 


F3 


4 


F4 


5 


F5 


6 


F6 


7 


F7 


8 


F8 


9 


F9 


A 


C1 


B 


C2 
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Error Conditions 



If an error occurs register 15 contains one of the following error 
codes: 

Code Meaning 

1 Line too lcng 

2 Channel 12 punch sensed (virtual 3211 only) 

3 Channel 9 punch sensed (virtual 3211 only) 

4 Intervention reguired 

5 Unknown error 

100 Printer not attached. 



PUNCHC 

Use the PUNCHC macro to write a line to a virtual card punch. The 
format of the PUNCHC macro is: 

| [label] | PUNCHCI line [ , ERROR = erraddr ] | 

w her e : 

label is an optional statement label. 

line specifies the line to be punched. It may be: 

•linetext 1 text enclosed in guotation marks, 
lineaddr the symbolic address of the line, 
(reg) a register containing the address of the line. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next seguential instruction in 
the calling program, as it does if no error occurs. 

Usage Notes 

1. No stacker selecting is allowed. The line length must be 80 
characters. 

2. You must issue the CP CLOSE command to close the virtual punch 
file. Issue the CLOSE command either from your program (using an 
SVC 202 instruction) or from the CMS environment when your program 
completes execution. The punch is closed automatically when you log 
off or when you use the CMS PUNCH command. 

Error Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

2 Unit check 

3 Unknown error 

100 Punch not attached 
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RDCARD 

Use the RDCARD macro to read a line from a virtual card reader. The 
format of the RDCARD macro is: 

| [label] | RDCARD | buf fer[ , length ][ , ERROR=erraddr ] 

where:: 

label is an optional statement label. 

buffer specifies the buffer address into which the card is to be 
read. It may be: 

bufaddr the symbolic address of the buffer. 

(reg) a register containing the address of the buffer. 

length specifies the length of card to be read. If omitted, 80 is 
assumed. The length may be specified in one of two ways: 

n a self-defining term indicating the length, 
(reg) a register containing the length. 

ERROR==erraddr 

specifies the address of an error routine to be given 
control if an error is found. If ERR0R= is not coded and an 
error occurs, control returns to the next seguential 
instruction in the calling program, as it does if no error 
occurs. 



Usage Notes 

1. Wo stacker selecting is allowed. 

2. Ihen the macro completes, register contains the length of the 
card that was read. 



l££°JE Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meanifi£l 

T End -of -file 

2 Unit check 

3 Unknown error 

5 Length not egual to reguested length 
100 Device not attached 
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RDTAPE 

Use the RDTAPE macro to read a record from the specified tape drive. 
The format of the RDTAPE macro is: 

| [label] | RDTAPE | buffer, length [, device] [,MODE=mode] | 

I | | [,ERROR=erradr] I 

where : 

label is an optional statement label. 

buffer specifies the buffer address into which the record is to be 
read. It may be specified in either of two ways: 

lineaddr the symbolic address of the buffer. 

(reg) a register containing the address of the buffer. 

length specifies the length of the largest record to be read. A 
65,535-byte record is the largest record that can be read. It 
may be specified in either of two ways: 

n a self -defining term indicating the length, 
(reg) a register containing the length. 

device specifies the device from which the line is to be read. If 
omitted, TAP1 (virtual address 181) is assumed. It may be 
specified in either of two ways: 

TAPn indicates the symbolic tape number (TAP1 through 

TAP4) . 
cuu indicates the virtual device address. 

MODE=mode specifies the number of tracks, density, and tape recording 
technigue options. It must be in the following form: 

([track ],[ density ],[ trtch ]) 

track 7 indicates a 7-track tape (implies density=800 and 
trtch=0) . 
9 indicates a 9-track tape (implies density=800) . 

density 200, 556, or 800 for a 7-track tape. 

800, 1600, or 6250 for a 9-track tape. 

trtch indicates the tape recording technique for 
7-track tape. One of the following must be 
specified : 

- odd parity, converter off, translator off. 
OC - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 

ERROR=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 
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1. When the macro completes, register contains the number of bytes 
read. 

2. You do not need to specify MODE when you are reading from a 9-track 
tape and using the default density of the tape drive or when you 
are reading from a 7-track tape with a density of 800 bpi, odd 
parity, with the data converter and the translator off. 

M.LE9.L £2Il<Iitions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

1 Invalid function or parameter list 

2 End-of-file or end-of-tape 

3 Permanent I/O error 

4 Invalid device address 

5 Tape not attached 



RDTERM 

Use the RDTERM macro to read a line from the terminal into an I/O 
buffer. The format of the RDTERM macro is: 



(NO j 



III r nl 

| | [label] | RDTERM | buf f er[ ,EDIT=code ][ ,LENGTH=length ]| , ATTREST= 

I I I I I 

III L J l 

wh ere : 

label is an optional statement label. 

buffer specifies the address of a 130-character buffer into which the 
line is to be read. It may be: 

lineaddr the symbolic address of the buffer, 
(reg) a register containing the address of the buffer. 

EDIT=code specifies the type of editing, if any, to be performed on the 
input line. 

NO indicates that a logical line is to be read and no 
editing is to be done. 

PAD reguests that the input line be padded with blanks 
to the length specified. 

UPCASE reguests that the line be translated to uppercase. 

YES indicates both padding and translation to uppercase. 
YES is the default. 

PHYS indicates that a physical line is to be read. When 
PHYS is specified, the LENGTH and ATTREST operands 
may also be entered. 
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LENGTH=length 

specifies the length of the buffer. If not specified, 130 is 
assumed. When EDIT=PHYS, as many as 2030 bytes may be read. 

ATTREST=YES|NO 

specifies whether an attention interrupt during a read should 
result in a restart of the read operation. (See Note 2.) 

Usage Notes 

1. When the macro completes, register contains the number of 
characters read. 

2. You can use ATTREST only when you are reading physical lines 
(EDIT=PHYS) and you specify an explicit length of the line. When 
ATTREST=NO, an attention interrupt during a read operation signals 
the end of the line and does not result in a restart of the read. 
These operands are used primarily in writing VS APL programs. 

3. You may wish to use the WAITT macro to ensure that terminal I/O is 
completed before you modify or use the read buffer. 

l££2£ Conditions 

When an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

2 Invalid parameter 

4 Read was terminated by an attention signal (Possible only when 
ATTREST=NO.) 



REGEQU 

Use the REGEQU macro to generate a list of EQU (eguate) statements to 
assign symbolic names for the general, floating-point, and extended 
control registers. The format of the REGEQU macro is: 



i — 

| | REGEQU | 
i 
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H§i £3^ .1.2 tes 



1. 



The REGEQU macro 


causes th 


generated: 






General 


Registers 


B1 


EQU 


1 


R1 


EQU 


1 


R2 


EQU 


2 


R3 


EQU 


3 


R4 


EQU 


4 


R5 


EQU 


5 


R6 


EQU 


6 


R7 


EQU 


7 


R8 


EQU 


8 


R9 


EQU 


9 


R10 


EQU 


10 


R11 


eq'u 


11 


R12 


EQU 


12 


R13 


EQU 


13 


R14 


EQU 


11 


R15 


EQU 


15 


Floating 


-Point 


Registers 



the following eguate statements to be 



Extended Control Registers 
CO 
C1 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 
C10 
C11 
C12 
C13 
C14 
C15 



EQU 





EQU 


1 


EQU 


2 


EQU 


3 


EQU 


4 


EQU 


5 


EQU 


6 


EQU 


7 


EQU 


8 


EQU 


9 


EQU 


10 


EQU 


11 


EQU 


12 


EQU 


13 


EQU 


14 


EQU 


15 



F0 EQU 

F2 EQU 2 

F4 EQU 4 

F6 EQU 6 



TAPECTL 



Use the TAPECTL macro to position the specified tape according to the 
specified function code. The format of the TAPECTL macro is: 

| [label] | TAPECTL | function [, device ][ , MODE=mode][ ,ERROR=erraddr ] | 



where : 
label 



is an optional statement label. 



function specifies the control function to be performed. It must be 
one of the following codes: 

Code Function 

REW Rewind the tape 

RUN Rewind and unload the tape 

ERG Erase a gap 

BSR Backspace one record 

BSF Backspace one file 

FSR Forward space one record 

FSF Forward space one file 

WTM Write a tape mark 

device specifies the tape on which the control operation is to be 
performed. If omitted, TAP1 (virtual address 181) is assumed. 
It may be: 

TAPn indicates the symbolic tape number (TAP1 through 

TIP4) . 
cuu indicates the virtual device address. 
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MODE=mode specifies the number of tracks, density, and tape recording 
technique options. It must be in the following form: 

([ track], [ density ],[ trtch ]) 

track 7 indicates a 7-track tape (implies density=800 and 
trtch=0) . 
9 indicates a 9-track tape (implies density=800) . 

density 200, 556, or 800 for a 7-track tape. 

800, 1600, or 6250 for a 9-track tape. 

trtch indicates the tape recording technique for 
7-track tape. One of the following must be 
specified: 

- odd parity, converter off, translator off. 
OC - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 

ERROB=erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERR0R= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

fi§§3® Notes 

1. You do not need to specify MODE when you are manipulating a 9-track 
tape and you are using the default density for the tape drive, nor 
when you are writing a 7-track tape with a density of 800 bpi, odd 
parity, with data convertor and translator off. 

IE£2I Conditions 

If an error occurs, register 15 contains one of the following error 
codes: 

Code Meaning 

1 Invalid function or parameter list. 

2 End-of-file or end-of-tape 

3 Permanent I/O error 

4 Invalid device id 

5 Tape is not attached 

6 Tape is file protected 
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WAITD 

Use the WAITD macro to cause the program to wait until the next 
interrupt occurs on the specified device. The format of the WAITD macro 
is: 

| [label] | WAITD | device. ..[ ,devicen ] [ ,ERROR=erraddr ] | 

wh er e s 

label is an optional statement label. 

devicen specifies the device (s) to be waited for. One of the 
following may be specified: 

symn indicates the symbolic device name and number, where: 

sym is CON, DSK, PRT r PUN, RDR, or TAP. 
n indicates a device number. 

user is a 4-character symbolic name specified a HNDINT macro 
issued for the same device. 

ERROR-erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERROR= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

Usacje Notes 

1. Use the WAITD macro to ensure completion of an I/O operation. If 
an interrupt has been received and not processed from a device 
specified in the WAITD macro the interrupt is processed before 
program execution continues. 

2. When the interrupt has been completely processed, control is 
returned to the caller with the name of the interrupting device in 
register 1 . 

3. If an HNDIHT macro issued for the same device specified ASAP and an 
interrupt has already been processed for the device, the wait 
condition is satisfied. 

4. If an HNDINT macro issued for the same device specified WAIT and an 
interrupt for the device has been received, the interrupt handling 
routine is given control. 

5. The interrupt routine determines if an interrupt is considered 
processed or if more interrupts are necessary to satisfy the wait 
condition. For additional information see the discussion of the 
HNDINT macro. 

IEE2I Conditions 

When an error is detected, register 15 contains a 1 to indicate that an 
invalid device number was specified. 
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WAITT 

Use the WAITT macro to cause the program to wait until all of the 
pending terminal I/O is complete. The format of the WAITT macro is: 

| [label] | WAITT | I 

where : 

label is an optional statement label. 

Usa<je Notes 

1. The WAITT macro synchronizes input and output to the terminal; it 
ensures that the console stack is cleared before the program 
continues execution. Also, you can ensure that a read or write 
operation is finished before you modify an I/O buffer. 



WRTAPE 

Use the WRTAPE macro to write a record on the specified tape drive. The 
format of the WRTAPE macro is: 

| [label] | WRTAPE | buffer, length [, device] [,MODE=mode] | 

I | | [ ,ERROR=erraddr] I 

w her e : 

label is an optional statement label. 

buffer specifies the address of the record to be written. It may be: 

lineaddr the symbolic address of the line, 
(reg) a register containing the address of the time. 

length specifies the length of the line to be written. It may be 
specified in either of two ways: 

n a self-defining term indicating the length, 
(reg) a register containing the length. 

device specifies the device to which the record is to be written. If 
omitted, TAP1 (virtual address 181) is assumed. It may be: 

TAPn indicates the symbolic tape number (TAP1 through 

TAP4) . 
cuu indicates the virtual device address. 

MODE=mode specifies the number of tracks, density, and tape recording 
technique. It must be in the following form: 

([ track ],[ density ],[ trtch ]) 

track 7 indicates a 7-track tape (implies density=800 and 
trtch=0) . 
9 indicates a 9-track tape (implies density=800) . 
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density 200 r 556 , or 800 for a 7-track tape 

800, 1600, or 6250 for a 9-track tape. 

trtch indicates the tape recording technique for 
7-track tape. One of the following must be 
specified : 

- odd parity, converter off, translator off. 
OC - odd parity, converter on, translator off. 
OT - odd parity, converter off, translator on. 
E - even parity, converter off, translator off. 
ET - even parity, converter off, translator on. 

ERROR= : erraddr 

specifies the address of an error routine to be given control 
if an error is found. If ERR0R= is not coded and an error 
occurs, control returns to the next sequential instruction in 
the calling program, as it does if no error occurs. 

Usage Notes 

1. You do not need to specify the MODE option if you are writing to a 
9-track tape and want to use the default density, nor if you are 
writing to a 7-track tape with a density of 800 bpi, odd parity, 
with data convertor and translator off. 

Error Conditions 

If an error occurs, register 15 contains one of the following error 
codes:: 

£2*16 Meaning 

1 Invalid function or parameter list 

2 End-of-file or end-of-tape 

3 Permanent I/O error 

4 Invalid device identification 

5 Tape not attached 

6 Tape is file protected 



338 IBM VM/370: CMS Command and Macro Reference 



WRTERM Macro 

WRTERM 

Use the WRTERM macro to display a line at the terminal. The format of 
the WRTERM macro is: 

| [label] | WRTERM | line [ , length] [ r EDIT=code ] [ ,COLOR=color ] 

wh ere : 

label is an optional statement label. 

line specifies the line to be displayed. It may be one of three 
forms: 

•linetext* the actual text line enclosed in quotation marks, 
lineaddr the label on the statement containing the line, 
(reg) a register containing the address of the line. 

length specifies the length of the line. If the line is specified 
within quotation marks in the macro, the length operand may be 
omitted. The length may be specified in either of two ways: 

n a self-defining term indicating the length, 
(reg) a register containing the length. 

EDIT=code specifies whether the line is to be edited: 

YES indicates that trailing blanks are to be removed and a 
carriage return added to the end of the line. YES is the 
default value. 

NO indicates that trailing blanks are not to be removed and 
no carriage return is to be added. 

LONG indicates the line may exceed 130 bytes, and is to be 
transmitted from the caller's buffer area. No editing is 
performed. 

COLOR=color 

indicates the color in which the line is to be typed, if the 
typewriter terminal has a two-color ribbon: 

B indicates that the line is to be typed in black. This is 

the default. 
R indicates that the line is to be typed in red. 

U§1L3§ Notes 

1. The maximum line length is 130 characters for a black line and 126 
characters for a red line. 

2. If EDIT=LONG, COLOR must be specified as , B». In this case, you may 
write as many as 1760 bytes with a single WRTERM macro. You are 
responsible for embedding the proper terminal control characters in 
the data, and for the integrity of the data from issuance of WRTERM 
until the data has been sent. (This operand is for use primarily 
with VS APL programs.) 

3. You may want to use the WAITT macro to ensure that terminal I/O is 
complete before continuing program execution. 
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The following appendixes are provided for your convenience: 

Appendix A: Reserved Filetype Defaults 

Appendix B: DOS/VS Access Method Services and VSAM Functions Not 
Supported In CMS 

Appendix C: OS/VS Access Method Services and VSAM Functions Not 
Supported In CMS 
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Appendix A: Reserved Filetype Defaults 



I Filet ype 


RECFM 


LRECL 


ZONE 


TRONC 


VERIFY|SERIAL|TABS 


Usage | 


Idefault 


F 


80 


1 * 


* 


1 * 


OFF 


1,6,11,16,21,26,31, 
36,41,46,51,61,71,81 
91,101,111,121,131 


All other filetypes | 


IAHSEBV 


F 


80 


2 72 


72 


1 72 


OFF 


2,6,11,16,21,26,31, 
36,41,46,51,61,71,80 


Input Control statements for | 
Access Method Services | 


| ASSEMBLE 


F 


80 


1 71 


71 


1 72 


ON 


1,10,16,31,36,41,46, 
69,72,80 


Asseobler language source | 
statements. | 


| BASIC 
IBASDATA 


F 


80 


7 * 


* 


1 * 


L/L 


7,10, 15,20,25,30,80 


BASIC source statements; and | 
execution— time files. | 


| COBOL 


F 


80 


1 72 


72 


1 72 


ON 


1,8,12,20,28,36,44, 
68,72,80 


COBOL source statements. | 


IDIBECT 


F 


80 


1 72 


72 


1 72 


ON 


1,6,11, 16,21,26,31, 
36,41,46,51,61,71 


VM/370 user directory entries. | 


IEXEC 


V 


80 


1 * 


* 


1 * 


OFF 


1,6,11,16,21,26,31, 
36,41,46,51,61,71 


EXEC procedures. | 


IFREEFORT 


V 


81 


9 * 


* 


1 * 


L/L 


9,15, 18,23,28,33,38, 
81 


FREEFORM FORTRAN source | 
statements. | 


| FORTRAN 


F 


80 


1 72 


72 


1 72 


ON 


1,7,10,15,20,25,30,80 


FORTRAN source statements. | 


| LISTING 


V 


121 


1 * 


* 


1 * 


OFF 


1,6,11,16,21,26,31, 
36,41,46,51,61,71,81 
91,101,111,121,131 


Command, program, and compiler | 
listings. | 


| MACRO 


F 


80 


1 71 


71 


72 


ON 


1,10,16,31,36,41,46, 
69,72,80 


Macro definitions. | 


IMEMO 


F 


80 


1 * 


* 


1 * 


OFF 


1,6,11,16,21,26,31, 
36,41,46,51,61,71 


Documentation. (Default CASE | 
value is M.) | 


IPLI 

| PLIOPT 


F 


80 


2 72 


72 


1 72 


ON 


2,4,7,10, 13, 16, 19,22, 
25,31,37,43,49,55, 
79,80 


PL/I Source statements. | 


ISCRIPT 


V 


132 


1 * 


* 


1 * 


OFF 


(IMAGE setting is 
CANON.) 


SCRIPT text processor input. | 
(Default CASE setting is H.) | 


| UPDATE 


F 


80 


1 71 


71 


72 


ON 


1,10,16,31,36,41,46, 
69,72,80 


Update files for assembler | 
language programs. | 


|UPDTxxxx 


F 


80 


1 71 


71 


72 


ON 


1,10,16,31,36,41,46, 
69,72,80 


Update files for assembler | 
language programs. | 


IVSBASIC 


F 


80 


7 * 


* 


1 * 


L/L 


7,10,15,20,25,30,80 


vs BASIC source statements. | 


IVSBCATA 


V 


132 


1 * 


* 


1 * 


OFF 


1,6,11,16,21,26,31, 
36,41,46,51,61,71, 
81. -.131 


VS BASIC execution— time files. | 


|* inc 
|L/L inc 


licates 
licates 


that tl 
that t] 


le ZONE 
ie LINE1 


TRUNC 
10DE se1 


or VEB 
:ting is 


tIFY set 
3 LEFT, 


.ting is equal to the ci 
with serial numbers on 


irrent record length | 
the left. | 



Figure 19. Default EDIT Subcommand Settings for CMS Reserved Filetypes 
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Appendix B: DOS/VS Access Method Services and VSAM 
Functions Not Supported in CMS 



Refer to the DOS/VS Utilities Access Method Services, 6033^5382, for a 
description of Access Method services functions available under DOS/VS, 
and, therefore, under CMS. This knowledge of Access Method Services is 
assumed throughout this publication. 

All of the DOS/VS Access Method Services are supported by CMS, except 
for the following: 

• Non-VSAM data sets with data formats that are not supported by 
CMS/DOS (for example, BDAM and ISAM files are not supported) . 

• The SHARE0PTI0NS operand has no function in CMS. However, you should 
specify SHARE0PTI0NS 3 in your DEFINE control statement for more 
efficient operations. When you specify SHARE0PTI0NS 3, CMS does not 
execute the code that attempts to reserve and release system 
resources. 
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, Appendix C: OS/VS Access Method Services and VSAM 

Functions Not Supported in CMS 



In CMS, an OS user is defined as a user that has not issued the command: 

SET DOS ON (VSAM) 

OS users can use all of the Access Method Services functions that are 
supported by DOS/VS, with the following exceptions: 

• Non-VSAM data sets with data formats that are not supported by 
CMS/DOS (for example, BDAM and ISAM files are not supported) . 

• The SHAREOPTIONS operand has no function in CMS. However, you should 
specify SHAREOPTIONS 3 in your DEFINE control statement for more 
efficient operation. When you specify SHAREOPTIONS 3, CMS does not 
execute the code that attempts to reserve and release system 
resources. 

• Do not use the AUTHORIZATION (entrypoint) operand in the DEFINE and 
ALTER commands unless your own authorization routine exists on the 
DOS core image library, the private core image library, or in a CMS 
DOSLIB file. In addition, results are unpredictable if your 
authorization routine issues an OS SVC instruction. 

• Unlike OS, CMS Access Method Services supports the 3330-11 as a 
virtual 3330-1; only a maximum of 404 cylinders are used. 

• The secondary space allocation parameter in the following DEFINE 
commands is not used by Access Method Services or DOS/VS VSAM: DEFINE 
SPACE, DEFINE USERCATALOG, and DEFINE CLUSTER with the UNIQUE 
parameter. However, you may code this parameter to make your control 
statement file compatible with an OS/VS VSAM control file. 

• The OS Access Method Services GRAPHICS TABLE options and the TEST 
option of the PARM command are not supported. 

• The filename in the FILE (filename) operands is limited to 7 
characters. If an eighth character is specified, it is ignored. 

• The OS Access Method Services CNVTCAT and CHKLIST commands are not 
supported in DOS/VS Access Method Services. In addition, all OS 
Access Method Services commands that support the 3850 Mass Storage 
System are not supported in DOS/VS Access Method Services. 

• Figure 20 is a list of OS operands, by control statement, that are 
not supported by the CMS interface to DOS/VS Access Method Services. 

If any of the unsupported operands or commands in Figure 20 are 
specified, the AMSERV command terminates and displays an appropriate 
error message. 

When you use the PRINT, EXPORT, IMPORT, IMPORTRA, EXPORTRA, and REPRO 
control statements for seguential access method (SAM) data sets, you 
must specify the ENVIRONMENT operand with the reguired DOS options (that 
is, PRIME DATA DEVICE, BLOCKSIZE, RECORDSIZE, or RECORDFORMAT) . You 
must have previously issued a DLBL for the SAM file. 

AMSERV can write SAM data sets only to a CMS disk, but can read them 
from DOS, OS, or CMS disks. 
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I OS Access Method Services 
| Control Statement 


I Operands not 

I supported in CMS 




| ALTER 


EMPTY/NOEMPTY 
| SCRATCH/NOSCRATCH 

DESTAGEWAIT/NODESTAGEWAIT 
| STAGE/BIND/CYLINDERFAULT 




| BLDINDEX 


| INDATASET 
OUTDATASET 




| DEFINE 


ALIAS | 
| EMPTY/NOEMPTY | 

GENERATIONDATAGROUP | 
| PAGESPACE | 

SCRATCH/NOSCRATCH | 
| DESTAGEWAIT/NODESTAGEWAIT | 

STAGE/BIND/CYLINDERFAULT | 
t TO/FOR/OWNER * | 


| DELETE 


ALIAS 

GENERATIONDATAGROUP 
PAGESPACE 
SCRATCH/NOSCRATCH 




1 EXPORT 


OUTDATASET 




J IMPORT 


INDATASET | 
OUTDATASET | 
IMPORTA | 


1 LISTCAT | 


ALIAS 

GENERATIONDATAGROUP 

LEVEL 

OUTFILE* 

PAGESPACE 




| PRINT | 


INDATASET | 
OUTFILE 2 | 


| REPRO 


INDATASET 
OUTDATASET 




| VERIFY | 


DATASET | 


|*The TO/FOR/OWNER operands are 
| Services interface, but are nc 
| control statement. 
|2The OUTFILE operand is support 
| interface, but is not supporte 
1 statements. 


supported for the Access Method | 
)t supported for the DEFINE NONVSAM | 

.ed by the Access Method Services j 
>d for the LISTCAT and PRINT control | 



Figure 20. OS Access Method Services Operands Not Supported in CMS 
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S$ special variable 299 

in &IF control statement 288 

setting 279 
&* special variable 299 

in &IF control statement 288 

setting 279 
&ARGS control statement, description 279 
SBEGEMSG control statement 

ALL operand 280 

description 279 
SBEGPUNCH control statement 

ALL operand 281 

description 281 
SBEGSTACK control statement 

ALL operand 281 

description 281 

FIFO operand 281 

LIFO operand 281 
SBEGTYPE control statement 

ALL operand 282 

description 282 
SCONCAT built-in function, description 297 
SCONTINUE control statement 282 

used with &ERROR control statement 285 
&CONTROL control statement 

ALL operand 283 

CMS operand 283 

description 283 

ERROR operand 283 

MSG operand 283 

NOMSG operand 283 

NOPACK operand 283 

NOTIME operand 283 

OFF operand 283 

PACK operand 283 

TIME operand 283 
SDATATYPE built-in function, description 

297 
&DISK* special variable 300 
SDISK? special variable 300 
SDISKx special variable 299 
&DOS special variable 300 
&EMSG control statement, description 284 
SEND control statement 285 

with &BEGEMSG control statement 279 

with SBEGPUNCH control statement 281 

with &BEGSTACK control statement 281 

with SBEGTYPE control statement 282 
&ERROR control statement, description 285 
SEXEC special variable 300 
SEXIT control statement, description 286 
&GLOBAL special variable 300 
SGLOBALn special variable 301 
SGOTO control statement 

description 287 

TOP operand 287 
&HEX control statement 

description 287 

OFF operand 287 

ON operand 287 
SIF control statement, description 288 
&INDEX special variable 301 

setting 279,291 
SLENGTH built-in function, description 297 



SLINENUM special variable 301 
&LITERAL built-in function, description 

298 
&LOOP control statement, description 289 
Sn special variable 299 

&PUNCH control statement, description 290 
SREAD control statement 

ARGS operand 291 

description 291 

VARS operand 291 
SREADFLAG special variable 301 

testing 291 
SRETCODE special variable 301 
SSKIP control statement, description 291 
&SPACE control statement, description 292 
SSTACK control statement 

description 293 

FIFO operand 293 

LIFO operand 293 
SSUBSTR built-in function, description 298 
&TIME control statement 

description 294 

OFF operand 294 

ON operand 294 

RESET operand 294 

TYPE operand 294 
6TYPE control statement, description 295 
STYPEFLAG special variable 301 
SO special variable 299 



$DUP edit macro 261 
$LISTI0 EXEC file 
creating 123 
format 123 
$MOVE edit macro 262 
DOWN operand 262 
TO operand 262 
OP operand 262 



* (asterisk) 

entered in fileid 15 
in ACCESS command 26 
in ALTER subcommand 220 
in CHANGE subcommand 224 
in COPYFILE command 43 

examples 47 
in DELETE subcommand 227 
in DLBL command 68 
in DSERV command 84 
in EDIT command 86 
in FILEDEF command 96 
in GETFILE subcommand 233 
in LISTDS command 116 
in LISTFILE command 121 
in PRINT command 144 
in PUNCH command 149 
in READCARD command 160 
in RENAME command 164 
in SCROLL/SCROLLUP subcommand 249 
in START command 179 
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349 



in STATE and STATEW commands 180 

in TAPPDS command 197 

in TRUNC subcommand 253 

in TYPE subcommand 254 

in VERIFY subcommand 256 

in ZONE subcommand 258 

with DISK operand, of CMS QUERY command 

156 
with REPEAT subcommand 244 
with RESET option 

of INCLUDE command 113 
of LOAD command 125 
* (comment) command 13 
*COPY statement 136 



/ (diagonal) , used in ACCESS command 26 



./ * (comments) UPDATE control statement 

209 
./ D (DELETE) UPDATE control statement 208 
./ I (INSERT) update control statement 207 
./ S (SEQUENCE) UPDATE control statement 

206 
»/ R (REPLACE) UPDATE control statement 

208 



%, used to pass a null argument to an EXEC 
procedure 299 



subcommand, description 259 

used with DSN operand of DLBL command 

69 
used with the FILEDEF DISK operand 101 



(equal sign) 

in COPYFILE command 43 
examples 46,47 

in RENAME command 165 
subcommand (see REUSE subcommand) 



A 

A operand of LISTIO command 123 

ABBREV operand 

of CMS QUERY command 153 
of CMS SET command 172 

relationship to SYNONYM command 189 
abbreviating commands 14 
abbreviations 

determine whether abbreviations are 

accepted for command names 153 
for CMS and user-written command names 

172, 187 
make command abbreviations acceptable as 

input 172 
make command abbreviations unacceptable 

as input 172 
used with synonyms 189 
abnormal termination (abend) 

effect on DLBL definitions 69 



effect on FILEDEF definitions 100 
entering debug environment after 263 
ACCESS command 

description 26 
ERASE option 26,27 
examples 27 

first command after IPL 26 
NODISK option 26 
NOPROF option 26 
Access Method Services 

allocating VSAM space 75 
allocating VSAM space in CMS/DOS 72 
control statements, operands not 

supported in CMS (OS users) 348 
determine free space extents for 117 
invoking in CMS 29 
LISTING file created by 29 
restrictions 

for DOS/VS users 345 
for OS/VS users 347 
accessing 

CMS files, FSREAD macro 309 

CMS with no virtual disks attached to 

your virtual machine 26 
disks, after the LINK command 27 
only particular files on a disk 27 
OS and DOS disks 28 
virtual disks 26 
ADD operand 

of the MACLIB command 135 
of TXTLIB command 200 
adding 

a member to a TXTLIB 200 
members to a macro library 135 
phases to a DOSLIB 82 
A-disk, accessed after IPLing CMS 27 
ALIGN option, of ASSEMBLE command 35 
alignment of boundaries in assembler 

program statements 35 
ALL 

operand 

of SBEGEMSG control statement 280 
of &BEGPUNCH control statement 281 
of 8BEGSTACK control statement 281 
of &BEGTYPE control statement 282 
of 6C0NTR0L control statement 283 
of LISTIO command 123 
of SERIAL subcommand 250 
option, of GENMOD command 109 
ALLOC option, of LISTFILE command 121 
ALOGIC option, of ASSEMBLE command 33 
ALTER subcommand 
description 220 
effect of zone setting 258 
altering 

characters in a CMS file 

with the ALTER subcommand 220 
with the CHANGE subcommand 223 
with the COPYFILE command 51 
constants, with LOAD command 132 
instructions, with LOAD command 132 
AMSERV 

command 

description 29 
LISTING file 29 
PRINT option 29 
TAPIN option 29 
TAPOUT option 29 
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filetype 30 

default editor settings 343 
annotating, console sheet 13 
APPEND option 

of COPYFILE command 45 
of LISTFILE command 121 
of LISTIO command 123 
appending 

information to $LISTIO EXEC 123 
information to a CMS EXEC file 121 
one file to another 45 
ARGS operand of &READ control statement 

291 
arguments 

in an EXEC procedure 279 

reading from the terminal or console 
stack 291 

testing how many were passed 301 
on the RUN command 168 
on the START command 179 
passed to an EXEC procedure 92 
arrange, records in a file in EBCDIC 

seguence 175 
ASA carriage control characters 328 
ASAP operand of HNDINT macro 315 
ASSEMBLE 

assembler input ddname 36 
command 11 

ALIGN option 35 

ALOGIC option 33 

BUFSIZE option 35 

DECK option 34 

description 32 

DISK option 34 

ESD option 33 

FLAG option 33 

LIBMAC option 33 

LINECOUN option 33 

LIST option 33 

listing control options for 33 

MCALL option 33 

MLOGIC option 33 

NOALIGN option 35 

NOALOGIC option 33 

NODECK option 34 

NOESD option 33 

NOLIBMAC option 33 

NOLIST option 33 

NOMCALL option 33 

NOMLOGIC option 33 

NONUM option 34 

NOOBJECT option 34 

NOPRINT option 34 

NORENT option 35 

NORLD option 33 

NOSTMT option 34 

NOTERM option 35 

NOXREF option 34 

NUMBER option 34 

OBJECT option 34 

PRINT option 34 

RENT option 35 

RLD option 33 

STMT option 34 

SYSPARM option 35 

SYSTERM listing 34 

TERMINAL option 34 



TEST option 34 
XREF option 33 

filetype 

created by TAPPDS command 197 
default editor settings 343 
used as input to the assembler 32 
ASSEMBLE command 

NOTEST option 34 

NOYFLAG option 35 

YFLAG option 35 
assembler 

conditional assembly statements, listing 
33 

overriding CMS file defaults 36 

using under CMS 11,32 
assembling 

source files 

identifying macro libraries 36,111 
ASSGN command 

DEN option 38 

description 37 

IGN operand 37 

LOHCASE option 38 

PRINTER operand 37 

PUNCH operand 37 

READER operand 37 

SYSxxx operand 37 

TAPn operand 37 

TERMINAL operand 37 

TRTCH option 38 

UPCASE option 38 

7TRACK option 38 

9TRACK option 38 
assigning 

logical units in CMS/DOS 37 

symbolic names, to storage locations in 
the debug environment 267 

values to variable symbols, in EXEC 
procedures 278 
assignment statement 278 
assignments 

logical unit, listing 123 

system and programmer, unassigning 162 
attention interrupt, causing 19 
ATTREST operand of RDTERM macro 333 
AUTO option 

of INCLUDE command 114 

of LOAD command 126 
automatic read function, setting 172 
automatic save function of the CMS Editor 

221 
AUTOREAD operand, of CMS SET command 172 
AUTOSAVE subcommand 

description 221 

OFF operand 221 
auxiliary directory, creating 107 
AUXPROC, option of FILEDEF command 100 



B 

backspace 

characters, how the editor handles 235 
key, used with OVERLAY subcommand 240 

backward space a tape 191 

BACKWARD subcommand, description 222 

BASDATA filetype, default editor settings 
343 
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base address, for debugging, set with 

ORIGIN subcommand 271 
BASIC filetype, default editor settings 

343 
BCD characters, converting to EBCDIC 45 
BDAM files, specifying in CMS 97 
beginning 

character string on a line, locating a 

line by 229 
program execution 
in CMS/DOS 94 

with the INCLUDE command 114 
with the LOAD command 126 
blank lines, displaying at the terminal 

during EXEC processing 292 
blanks 

as delimiters 12 

FIND subcommand 229 
displaying in LINEDIT message text 319 
overlaying characters with 240 
trailing 

removing with WRTERM macro 339 
truncating from variable- length file 
242 
blip 

characters 

for virtual machine 170 
for virtual machine, displaying 152 
function 

query the setting of 152 
setting 170 
BLIP operand 

of CMS QUERY command 152 
of CMS SET command 170 
BLKSIZE option, of FILEDEF command 98 
BLOCK option, of FILEDEF command 98 
blocking CMS files 98 

FSWRITE macro 313 
blocksize, specifying with FILEDEF command 

100 
books, from DOS/VS source statement 

libraries, copying 177 
BOTTOM subcommand, description 222 
boundary alignment, of statements in an 

assembler program 35 
branching 

in an EXEC procedure 

SGOTO control statement 287 
SSKIP control statement 292 
BREAK subcommand, description 264 
breakpoints, setting 264 
BSF, tape control function 191 
BSIZE operand, of FSCB macro 304 
BSR, tape control function 191 
BUFFA operand, of LINEDIT macro 325 
buffer 

specifying for RDTERM macro 332 
specifying for read/write operations, 

FSCB macro 304 
to copy LINEDIT message text 325 
BUFFER operand, of FSCB macro 304 
buffer size 

assembler, controlling size of 35 
for VSAM programs 70 
specifying, FSCB macro 304 
BUFSIZE option, of ASSEMBLE command 35 
BUFSP option, of DLBL command 70 
built-in functions, EXEC 296 



canceling 

automatic save function of the editor 

221 
changes made during edit session 242 
system and programmer logical unit 
assignments in CMS/DOS 38 
CANON operand, of IMAGE subcommand 234 
card reader 

reading files from, READCARD command 

159 
reading records from, RDCARD macro 330 
carriage control characters 
ASA, summary 328 

handling by PRINT command 144,145 
machine code 328 
CASE subcommand 

description 223 
M operand 223 
U operand 223 
CAT option of DLBL command 70 
example of usage 77 
example of usage in CMS/DOS 74 
catalogs (see VSAM catalogs) 
CAW 

operand of SET subcommand 273 
subcommand, description 265 
CAW (Channel Address Word) 

changing in the debug environment 273 
displaying in debug environment 265 
format 2 65 
CC option, of PRINT command 144 
CD operand, of DSERV command 84 
CHANGE 

option, of FILEDEF command 98 
option of DLBL command 69 
subcommand 

description 223 
effect of zone setting 258 
changing 

CAW (Channel Address Word) , in debug 

environment 273 
CSW (Channel Status Word) , in debug 

environment 273 
file identifier 

on SAVE subcommand 248 
with the FILE subcommand 229 
with the RENAME command 164 
filemode of a file, with the FMODE 

subcommand 230 
filename of a file 231 
general registers in the debug 

environment 273 
PSW (Program Status Word) , in debug 

environment 273 
record format of a file 242 
record length of a file 87 
special characters, on a 3270 225 
Channel Address Word (see CAW (Channel 

Address Word)) 
Channel Status Word (see CSW (Channel 

Status Word) ) 
CHAR, result of &DATATYPE built-in 

functions 297 
character 
data 

determining if a token contains 297 
displaying with LINEDIT macro 323 
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sets, used in CMS 14 
strings 

assigning to variable symbols 278 

changing 223 

copying 49 

extracting in an EXEC procedure 298 

locating 238 
translation 50 
characters 
altering 

with the ALTER subcommand 220 

with the CHANGE subcommand 223 

with the COPYFILE command 51 
blip, displaying 152 
for a blip string 170 
number in a token, determining 297 
valid in CHS command lines 14 
CLEAR 

operand 

of DLBL command 69 

of FILEDEF command 97 
option 

of INCLUDE command 113 

of LOAD command 125 

of SYNONYM command 186 
clearing 

DLBL definitions 69 

for released disks before program 
execution 75 
FILEDEF definitions 98,100 
phase libraries to binary zeroes, in 

CMS/DOS 83 
storage to zeros 

with the INCLUDE command 113 

with the LOAD command 125 
synonym table 186 
closing 

CMS files 306 

in EXEC procedures 306 
virtual card punch after PUNCHC macro 

329 
virtual printer after using PRINTL macro 
328 
CLR operand 

of HNDEXT macro 314 
of HNDINT macro 315 
of HNDSVC macro 316 
CMS 

loader (see loader) 

operand of &CONTROL control statement 

283 
operand of DLBL command 69 
subcommand, description 226 
CMS (Conversational Monitor System) 11 
basic description of 12 
Batch Facility (see CMS Batch Facility) 
command language, basic description 11 
commands (see CMS commands) 
Editor 12 
file identifier 

default for DLBL command 71 

default for FILEDEF command 100 
files (see also files) 

format 98 
macros (see CMS macro instructions) 
CMS Batch Facility 40 
halting 216 



CMS commands 
ACCESS 26 
AMSERV 29 
ASSEMBLE 32 
ASSGN 37 
CMSBATCH 40 
COMPARE 41 
COPYFILE 43 
CP 53 
DDR 54 
DEBUG 65 
DISK 66 

displaying during EXEC processing 283 
DLBL 68 
DOSLIB 79 
DOSLKED 81 
DSERV 84 
EDIT 86 
entering 12 
ERASE 88 
ESERV 90 
EXEC 92 
FETCH 94 
FILEDEF 96 
FORMAT 104 
GENDIRT 107 
GENMOD 108 
GLOBAL 111 
INCLUDE 113 
LISTDS 116 
LISTFILE 120 
LISTIO 123 
LOAD 125 
LOADMOD 134 
MACLIB 135 
MODMAP 138 
MOVEFILE 139 
not for general users 17 
nucleus resident 17 
OPTION 142 
PRINT 144 
PSERV 147 
PUNCH 149 
QUERY 152 
READCARD 159 
RELEASE 162 
RENAME 164 
RSERV 166 
RUN 168 

search order 18 
SORT 175 
SSERV 177 
START 179 
STATE 180 
STATEW 180 
summary 20 
SVCTRACE 182 
SYNONYM 186 
TAPE 190 
TAPEMAC 195 
TAPPDS 197 
transient area 16 
TXTLIB 200 
TYPE 202 
UPDATE 204 
valid in CMS subset 226 
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CMS EXEC file 

adding to 121 

creating 120 

format 121 
CHS files (see files) 
CHS Immediate, commands (see Immediate 

commands) 
CHS macro instructions 303 

COHPSWT 304 

FSCB 304 

FSCBD 305 

FSCLOSE 306 

FSERASE 307 

FSOPEN 308 

FSREAD 309 

FSSTATE 311 

FSWRITE 312 

HNDEXT 314 

HNDINT 315 

HNDSVC 316 

LINEDIT 317 

PRINTL 327 

PUNCHC 329 

RDCARD 330 

RDTAPE 331 

RDTERM 332 

REGEQU 333 

TAPECTL 334 

WAITD 336 

WAITT 337 

WRTAPE 337 

WRTERH 339 
CHS subset 226 

RETURN command 246 

returning to edit mode 246 
CHSAMS, saved system name 172 
CHSBATCH command, description 40 
CHSDOS, saved system name 172 
CHS/DOS environment 

description 12 

initializing 173 

leaving 173 

test whether it is active 158 
in an EXEC procedure 300 
CHSLIB, assembler macro library ddname 36 
CHSSEG, saved system name 172 
CHSDT1 file 

created by READCARD command 159 

created by TAPE LOAD command 193 

created by TAPPDS command 197 
CHSVSAH, saved system name 172 
COBOL 

compiler 

guerying options in effect for 158 
specifying options for in CHS/DOS 
142 

filetype, default editor settings 343 
COL option 

of COHPARE command 41 

of TYPE command 202 
COLOR operand of WRTERH macro 339 
columns 

comparing disk files by 41 

displaying particular 

with the TYPE command 202 
with the TYPE subcommand 255 

specifying 

for copy operations 49 



for verification setting 256 
for zone setting for an edit session 
258 
C0L1 option, of TAPPDS command 198 
command 

defaults, shown by underscore in command 

format box 15 
environment 
CMS 11 
CP 11 

definition 11 
execution, halting 217 
language, CHS 12 
languages, VH/370 11 
modules, creating 108 
operands 13 
options 13 
commands 

abbreviating 14 
entering 12 
truncating 14 
valid in CHS subset 226 
when to enter 19 
comments, in CHS command lines 13 
COHP 

operand 

of DOSLIB command 79 
of LINEDIT macro 319 
of HACLIB command 135 
option, of FETCH command 94 
COHPARE command 
COL option 41 
description 41 
comparing 

contents of CHS files 41 
tokens in an EXEC procedure 288 
comparison operators, in EXEC procedure 

288 
compile and execute programs, with the RUN 

command 168 
compilers, using under CHS 11 
components, of VH/370 11 
compressing 

CHS disk files 45 
HACLIB files 135 
TXTLIB files 200 
COHPSHT macro, description 304 
CONCAT option, of FILEDEF command 99 
concatenating 

OS macro libraries 99 
periods with EXEC variables 289 
tokens in an EXEC procedure, &C0NCAT 
built-in function 297 
conditional execution 

&IF control statement 288 
SLOOP control statement 289 
CONSOLE, value of &READFLAG special 

variable 301 
console read, after CHS command execution, 

controlling 172 
console stack 

reading data in an EXEC procedure 291 
stacking lines 

&BEGSTACK control statement 281 
&STACK control statement 293 
STACK subcommand 251 
testing whether it is empty 3 01 
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constants 

altering 

with LOAD command 132 
with the STORE subcommand 274 
continuation character 

on COPYFILE specification list 50 

on COPYFILE translation list 51 
Control Program (see CP (Control Program)) 
control statements 

for Access Method Services 30 

for DDR command 54 

for the UPDATE command 206 
controlling, tapes 191 
conventions, notational 14 
Conversational Monitor System (see CMS 

(Conversational Monitor System)) 
converting 

BCD characters to EBCDIC characters 45 

decimal data to EBCDIC, LINEDIT macro 
321 

decimal data to hexadecimal, LINEDIT 
macro 321 

fixed-length files to variable-length 
format 48,242 

hexadecimal data to EBCDIC, LINEDIT 
macro 317 

keypunch characters 45 

lowercase letters to uppercase, with the 
COPYFILE command 45 

uppercase letters to lowercase, with the 
COPYFILE command 45 

variable-length files to fixed- length 
format 48,242 
COPY 

filetype 

adding to MACLIBs 136 

created by the SSERV command 177 

function statement, of DDR command 57 
COPYFILE command 

APPEND option 45 

description 43 

EBCDIC option 45 

examples 46 

FILL option 45 

FOR option 44 

FRLABEL option 44 

FROM option 44 

incompatible options 46 

LOWCASE option 45 

LRECL option 45 

NEWDATE option 44 

NEWFILE option 44 

NOPROMPT option 44 

NOSPECS option 44 

NOTRUNC option 45 

NOTYPE option 44 

OLDATE option 44 

OVLY option 44 

PACK option 45 

PROMPT option 44 

RECFM option 45 

REPLACE option 44 

specification list 49 

SPECS option 44 

TOLABEL option 44 

TRANS option 45 

TRUNC option 45 

TYPE option 44 



UNPACK option 45 
UPCASE option 45 
usage 46 
copying 

books from DOS/VS source statement 

libraries 1 77 
character strings 49 
CMS files 43 

from one disk to another 47,230 
to files with different filenames 
231 
columns of data 50 

data from one device to another 139 
data from one file to another 43 
files from one device to another 54 
lines in a CMS file 261 
lines in a file being edited, from one 

position to another 262 
macros from DOS/VS E sublibraries 90 
modules from DOS/VS relocatable 

libraries 166 
parts of a CMS file 

with the COPYFILE command 47 
with the GETFILE subcommand 233 
procedures from a DOS/VS procedure 

library 147 
unloaded OS partitioned data sets into 
CMS MACLIBs 195 
core image 

libraries (DOS/VS) , displaying the 

directories of 84 
phases, in CMS/DOS 79 
COUNT option, of DDR command TYPE/PRINT 

function control statement 60 
CP (Control Program) 

basic description 11 
commands (see CP commands) 
CP command 

description 53 
implied 172 
when to use 53 
CP commands 

DETACH 162 

entering in CMS 53 

executing in CMS command environment 

172 
executing with LINEDIT macro 325 
CPU time, displaying in an EXEC procedure 

294 
creating 

auxiliary directories 107 

CMS EXEC file with the LISTFILE command 

120 
CMS files 

from tapes created by OS utility 

programs 197 
FSWRITE macro 312 
using the CMS Editor 86 
with the COPYFILE command 43 
with the READCARD command 159 
CMS macro libraries 135 

from OS partitioned data sets on tape 
195 
CMS TEXT libraries 200 
file system control block (FSCB) 304 
load map of a file 

with the INCLUDE command 114 
with the LOAD command 126 
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MODULE files 108 

user file; directory (ACCESS command) 26 
cross-reference table, assembler, listing 

33 
CSECTs, duplicate, for the LOAD command 
127 

csw 

operand of SET subcommand 273 
subcommand, description 266 
CSW (Channel Status Word) 

changing in the debug environment 273 
displaying in the debug environment 266 
format 266 
CTL option, of UPDATE command 205,210 
current line pointer 

position after deleting lines 227 
positioning 

at top-of-file 253 
BACKWARD subcommand 222 
based on character string 238 
BOTTOM subcommand 222 
DOWN subcommand 227 
FIND subcommand 229 
FORWARD subcommand 232 
LOCATE subcommand 238 
NEXT subcommand 239 
nnnnn subcommand 260 
UP subcommand 255 
cylinder 

extents for VSAM files 75 
in CMS/DOS 72 
cylinders 

counting number of on a virtual disk 

104 
on a virtual disk, resetting 104 



DASD Dump Restore program, invoking via the 

DDR command 54 
data, overlaying in a file 44 
DATE option, of LISTFILE command 121 
DD (data definition) , simulating in CMS 96 
D-disk, accessed after IPL of CMS 27 
ddnames 

defining 

with the DLBL command 68 
with the FILEDEF command 96 
entering tape ddnames for AMSERV 30 
for DLBL command, restrictions for OS 

users 75 
to identify VSAM catalogs 77 

in CMS/DOS 73 
used by the assembler 36 
used in CMS/DOS, for DOS/VS libraries 

71 
used in MOVEFILE command 139 
DDR 

command 

COPY function statement 57 

COUNT option of TYPE/PRINT function 

control statement 60 
description 54 
DUMP function statement 57 
example of TYPE/PRINT output 61 
GRAPHIC option of TYPE/PRINT function 
control statement 60 



HEX option of TYPE/PRINT function 

control statement 60 
INPUT control statement 55 
PRINT function statement 59 
RESTORE function statement 57 
SYSPRINT control statement 56 
TYPE function statement 59 
control statements, entering 54 
DEBUG 

command 12 

description 65 
subcommands 
BREAK 264 
CAW 265 
CSW 266 
DEFINE 267 
DUMP 268 
GO 269 
GPR 270 
HX 270 
ORIGIN 271 
PSW 272 
RETURN 272 
SET 273 
STORE 274 
X 275 
debug environment 12,65,263 
leaving 

with the GO subcommand 269 
with the RETURN subcommand 272 
setting origin value 271 
debugging, MODULE files 134 
decimal 

converting to EBCDIC, LINEDIT macro 321 
converting to hexadecimal, LINEDIT macro 
321 
DECK 

option 

of ASSEMBLE command 34 
of OPTION command 142 
default 

file identifier 

for DLBL command 71 
for FILEDEF command 100 
settings for the CMS Editor 
image 234 
preserving 241 
restoring 245 
summary 343 
TABSET 252 
TRUNC 254 
ZONE 258 
defaults, command, shown by underscore in 

command format box 15 
DEFINE subcommand, description 267 
defining 

data sets, with FILEDEF command 101 
files for CMS/DOS 68 
OS data sets under CMS 96 
VSAM files, with the DLBL command 68 
DEL operand 

of DOSLIB command 79 
of MACLIB command 135 
of TXTLIB command 200 
DELETE 

control statement, for UPDATE command 

208 
subcommand, description 227 
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deleting 

CMS disk files 88 

lines in a file being edited 227 

to a particular line 228 
members of a macro library 135 
members of a TXTLIB 200 
phases from a CMS/DOS phase library 79 
READ control cards 160 
records from a source file with the 
UPDATE command 208 
delimiters 

on a CHANGE subcommand 223 
on a command line 13 
on a DSTRING subcommand 228 
on LOCATE subcommand 238 
DEN option 

of ASSGN command 38 
of FILEDEF command 99 
of TAPE command 192 
density of tapes, specifying 192 
DET option of RELEASE command 162 
DETACH command 162 
detaching, disks 162 
device types 

default attributes for MOVEFILE command 

140 
valid for FILEDEF command operands 97 
devices, waiting for interrupts 336 
DIRECT, filetype, default editor settings 

343 
directories 

CMS auxiliary 107 
CMS file, writing to disk 162 
of DOS/VS libraries, obtaining 
information from 84 
discontiguous shared segment, saved system 

names 172 
DISK 

command 

DUMP operand 66 
LOAD operand 66 
operand 

of CMS QUERY command 155 
of FILEDEF command 97 
of FILEDEF command, examples 101 
of FILEDEF command, interactive use 
of 101 
option 

of ASSEMBLE command 34 
of DOSLIB command 79 
of DOSLKED command 81 
of DSERV command 84 
of MACLIB command 136 
of PSERV command 147 
of RSERV command 166 
of SSERV command 177 
of TAPE command 192 
of TXTLIB command 200 
of UPDATE command 205 
disk files (see files) 
disk storage capacity, displaying status of 

155 
disks 

accessing 26 

A-disk 27 

D-disk 27 

deleting files from 88 



determine 

if a disk is accessed, in an EXEC 

procedure 299 
if a disk is CMS OS or DOS, in an 

EXEC procedure 299 
if a disk is full 155 
the read/write status of 155 
DOS, accessing 28 
formatting 104 
OS, accessing 28 

releasing from your virtual machine 162 
S-disk 27 

writing labels on 104 
Y-disk 27 
DISP 

operand, of LINEDIT macro 324 
option, of FILEDEF command 99 
display 

mode, of the CMS Editor 87 
terminal, display mode 87 
DISPLAY operand of FORMAT subcommand 232 
display terminals 
display mode 231 
line mode 87 
displaying 

blank lines at the terminal during EXEC 

processing 292 
blanks in LINEDIT message text 319 
blip characters for virtual machine 152 
CAW (Channel Address Word) , in debug 

environment 265 
CMS commands during EXEC processing 283 
CMS files 202 

in hexadecimal format 202 
CMS files on a 3270 screen 248 
columns of a CMS file 202 
contents of storage, LINEDIT macro 322 
contents of virtual storage, in debug 

environment 275 
CSW (Channel Status Word) , in debug 

environment 266 
data at the terminal 

&BEGTYPE control statement 282 
LINEDIT macro 317 
data lines at the terminal 

&TYPE control statement 295 
determining if terminal is displaying 

301 
WRTERM macro 339 
DLBL definitions 70,157 
error messages 

during EXEC processing 283 
with the LINEDIT macro 325 
EXEC statements during EXEC processing 

283 
extents occupied by OS and DOS files 

116 
FILEDEF definitions 102,157 
filenames on a tape 191 
general registers, in the debug 

environment 270 
hexadecimal values in an EXEC procedure 

288 
information 

about CMS files 120 

about files on OS and DOS disks 116 

about MACLIB members 135 

about OS and DOS disks 116 
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last executed EDIT subcommand 259 
line numbers during line-number editing 

237 
list of CMS files on a tape 192 
load maps 126 

of MODULE files 138 
members of CMS libraries 203 
parameter lists during program 
execution, LIHEDIT macro 323 
particular columns of a file, during 

edit session 256 
particular records in a CMS file 202 
procedure from a DOS/VS procedure 

library 147 
PSW (Program Status Word) , in debug 

environment 272 
records in a CMS file, with the TYPE 

subcommand 254 
return code from EXEC, on Ready message 

286 
return codes during EXEC processing 283 
screensful of data in a file 248 
short form of editor error message 251 
time-of-day during EXEC processing 283 
timing information in an EXEC procedure, 
&TIME control statement 2 94 
DLBL 

command 

CAT option 70 

CHANGE option 69 

CLEAR operand 69 

CMS operand 69 

ddname restrictions (OS users) 75 

description 68 

DSN operand 69 

DUMMY operand 68 

entering SYSxxx operand 70 

establishing file definitions for the 
STATE command 180 

EXTENT option 69 

MULT option 69 

NOCHANGE option 69 

PERM option 69 

SYSxxx option 69 

to identify files for AMSERV 30 

VSAM option 69 

when to use (OS users) 75 
definitions 

cleared by the ESERV EXEC 90 

clearing before program execution 75 
operand of CMS QUERY command 157 
DMSLDR SYSUT1 file 126 
DOS 

disks, accessing 28 
files 

listing information 116 

specifying FILEDEF options for 100 
operand 

of CMS QUERY command 158 

of CMS SET command 173 
option of GENMOD command 109 
DOSLIB 

command 

COMP operand 79 

DEL operand 79 

description 79 

DISK option 79 

MAP operand 79 



PRINT option 79 
TERM option 79 
files 79 

adding phases to 82 
fetching phases from 94 
identify for fetching 111 
output filemode 81 
size considerations 80 
space considerations 82 
which DOSLIBs will be searched 158 
operand 

of CMS QUERY command 158 
of GLOBAL command 111 
DOSLKED command 
description 81 
DISK option 81 
PRINT option 81 
TERM option 82 
DOSLNK filetype 

CMS/DOS linkage editor input 81 
creating 82 
DOSPART operand 

of CMS QUERY command 158 
of CMS SET command 173 
DOT operand of LINEDIT macro 319 
DOWN 

operand, of $M0VE edit macro 262 
subcommand, description 227 
DSECT, for file system control block (FSCB) 

305 
DSERV command 

CD operand 84 
description 84 
DISK option 84 
PD operand 84 
PRINT option 84 
RD operand 84 
SD operand 84 
SORT option 84 
TD operand 84 
TERM option 84 
DSN operand of DLBL command 69 
DSORG option, of FILEDEF command 99 
DSTRING subcommand, description 228 
DUMMY 

operand 

of DLBL command 68 

of DLBL command, restrictions for OS 

VSAM user 70 
of DLBL command, using in CMS/DOS 71 
of FILEDEF command 97 
DUMP 

function statement, of DDR command 57 
operand 

of DISK command 66 
of TAPE command 191 
option, of OPTION command 142 
subcommand, description 268 
dumping 

CMS files 

to tape 191 

to the virtual card punch 66 
contents of virtual storage 268 
mindisks to tape 54 
DUP option 

of INCLUDE command 114 
of LOAD command 126,127 
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duplicate CSECTs, for the LOAD command 127 
duplicating, lines in a CHS file 261 



E 
EBCDIC 

display a file in 202 

option, of COPYFILE command 45 
EDIT 

command 12 

description 86 
LRECL option 87 
NODISP option 87 

operand 

of RDTERM macro 332 
of WRTERM macro 339 

subcommand environment 12 

subcommands (see EDIT subcommands) 
edit environment 219 
edit macros 

$DUP 261 

$MOVE 262 
edit mode 219 

leaving with the FILE subcommand 229 

of CMS Editor 12 
EDIT subcommands 12 

? 259 

= 246 

affected by zone setting 258 

ALTER 220 

AUTOSAVE 221 

BACKWARD 222 

BOTTOM 222 

CASE 223 

CHANGE 223 

CMS 226 

DELETE 227 

DOWN 227 

DSTRING 228 

FILE 229 

FIND 229 

FMODE 230 

FNAME 231 

FORMAT 231 

FORWARD 232 

GETFILE 233 

IMAGE 234 

INPUT 235 

LINEMODE 236 

LOCATE 238 

LONG 238 

NEXT 239 

nnnnn 260 

OVERLAY 240 

PRESERVE 241 

PROMPT 241 

QUIT 242 

RECFM 242 

RENUM 243 

REPEAT 244 

REPLACE 245 

RESTORE 245 

REUSE 246 

SAVE 248 

SCROLL 248 

SCROLLUP 248 

SERIAL 249 



settings saved by PRESERVE subcommand 

241 
SHORT 251 
STACK 251 
TABSET 252 
TOP 253 
TRUNC 253 
TYPE 254 
UP 255 
VERIFY 256 
X 257 
Y 257 
ZONE 258 
edited 

error messages 

displaying with the LINEDIT macro 

325 
in an EXEC procedure 280 
macros, DOS/VS copying 90 
editing 

CMS files 219 

lines read with the RDTERM macro 332 
editor 

invoking 86 

settings for reserved filetypes, summary 
343 
END option, of TAPPDS command 198 
end-of-file 

effect of LOCATE subcommand 238 
position current line pointer at 222 
entering 

bytes of data on a SET subcommand 273 
CMS commands 12 

using synonyms 187 
commands, keyboard differences 19 
CP commands from the CMS command 

environment 53 
debug environment 

via breakpoint 263 
via DEBUG command 263 
via external interrupt 263 
edit environment 86 
EDIT subcommands, re-entering 246 
file identifications 

for the LISTDS command 117 
on the DLBL command 69 
on the FILEDEF command 101 
input lines by prompting 237 
operands on CMS assembler language macro 

instructions 303 
VSAM extent information 75 
in CMS/DOS 71 
ENTRY, loader control statement 129 
entry point 

determined by the loader 127 
displayed with FETCH command 94 
specifying 

with the ENTRY statement 129 
with the GENMOD command 108 
with the INCLUDE command 113 
with the LOAD command 125 
with the START command 179 
environments of CMS 12 
CMS Editor 12 
CMS/DOS 12 
debug 12 

EXEC facilities 12 
EOF option, of TAPE command 192 
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EOT option, of TAPE command 192 

EQU statements, generating for registers, 

REGEQU macro 334 
ERASE 

command 

description 88 
NOTYPE option 88 
TYPE option 88 
option of ACCESS command 26,27 
erasing 

all the CMS files on a disk 26 
CMS files 88 

during program execution 307 
ERG, tape control function 191 
ERROR 

operand 

of &C0NTR0L control statement 283 
of FSCLOSE macro 306 
of FSERASE macro 307 
of FSOPEN macro 308 
of FSREAD macro 309 
of FSSTATE macro 311 
of FSWRITE macro 312 
of HNDINT macro 315 
of HNDSVC macro 316 
of PRINTL macro 327 
of PUMCHC macro 329 
of RDCARD macro 330 
of RDTAPE macro 331 
of TAPECTL macro 335 
of WAXTD macro 336 
of WRTAPE macro 338 
error messages 
CMS 

displaying during EXEC processing 

283 
suppressing display during EXEC 
processing 283 
displayed by CMS Editor 238 
displayed by the CMS Editor 251 
displaying with LINEDIT macro 325 
issued in an EXEC procedure 280 

SEMSG control statement 284 
type in red 172 
VM/370 format 280 
errors 

encountered in macro instruction 

execution 303 
from Access Method Services 29,30 
in an EXEC procedure, specifying action 
to be taken 285 
ERRS, option, of OPTION command 142 
ESD option, of ASSEMBLE command 33 
ESERV command, description 90 
examining, virtual storage locations 275 
EXEC 

built-in functions 296 
SCONCAT 297 
6DATATYPE 297 
6LENGTH 297 
SLITERAL 298 
&SUBSTR 298 
command 12 

description 92 
implied 172 
control statements 277 
6ARGS 279 
&BEGEMSG 279 



&BEGPUNCH 281 

&BEGSTACK 281 

SBEGTYPE 282 

6C0NTINUE 282 

SCONTROL 283 

SEMSG 284 

&END 285 

6ERR0R 285 

&EXIT 286 

SGOTO 287 

&HEX 287 

SIF 288 

&LOOP 289 

&PUNCH 290 

SREAD 291 

SSKIP 291 

&SPACE 292 

&STACK 293 

&TIME 294 

&TYPE 295 

assignment statement 278 

displaying during EXEC processing 
283 
files 

SLISTIO EXEC created by LISTIO 
command 123 

CMS EXEC created by the LISTFILE 
command 120 

executing with the RUN command 168 
filetype 

default editor settings 343 

record format 92 
option 

of LISTFILE command 120 

of LISTIO command 123 
procedures 

defining synonyms for 186 

ESERV 90 

RON 168 
special variables 299 

&$ 299 

&* 299 

&DISK* 300 

&DISK? 300 

&DISKX 299 

&DOS 300 

&EXEC 300 

&GLOBAL 300 

&GLOBALn 301 

SINDEX 301 

&INDEX, setting 279 

&LINENUM 301 

&n 279,299 

&READFLAG 301 

&RETCODE 301 

&TYPEFLAG 301 

50 299 

&1 through &30 279 
executable statements 278 

in &IF control statement 288 
on &ERROR control statement 285 
execute, form of the LINEDIT macro 326 
executing 

conditional statements in an EXEC 

procedure 288 
CP commands 

in EXEC procedures 53 

in jobs for CMS Batch Facility 53 
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CP commands during program execution 

325 
EXEC procedures 16,92,277 
MODULE files 17,134 
programs 

in CMS/DOS 94 

with the INCLUDE command 114 
with the LOAD command 126 
with the BUN command 168 
with the START command 179 
programs in EXEC procedures, 

considerations for closing files 306 
TEXT files 

setting the starting point for 125 
with the RUN command 168 
execution 

entry point, resetting, with the INCLUDE 

command 113 
of a CMS command, halting 217 
summary in an EXEC procedure 283 
exiting, from an EXEC procedure 286 
extending, one disk from another 26 
extensions 

read-only 26 
accessing 27 
editing files on 86 
EXTENT option 

of DLBL command 69,75 

in CMS/DOS 72 
of LISTDS command 116 
extents 

for VSAM files 

determining free space for 116 
entering 75 
entering in CMS/DOS 72 
EXTERNAL command 263 
external interrupts 
effect in CMS 263 

provide processing routine for 314 
External Symbol Dictionary (ESD) 33 



FETCH command 

COMP option 94 
description 94 

identify DOSLIBs to be searched 111 
ORIGIN option 94 
FIFO operand of &STACK control statement 

293 
file 

definitions 

displaying DLBL definitions 157 
displaying FILEDEF definitions 157 
for the MOVEFILE command 139 
for the STATE command 180 
directories 

auxiliary 107 

set up with the ACCESS command 26 
identifier 

assigned with the TAPPDS command 197 
changing with the FILE subcommand 

229 
changing with the RENAME command 164 
changing with the SAVE subcommand 
248 



CMS, assigned with the READCARD 

command 159 
in command syntax 15 
file identification (see file identifier) 
FILE NOT FOUND error message, suppressing 

during EXEC processing 283 
file status table (FST) 311 
FILE subcommand, description 229 
file system control block (FSCB) (see 

FSCB) 
FILEDEF 
command 

BLKSIZE option 98 

BLOCK option 98 

CHANGE option 98 

CLEAR operand 97 

CONCAT option 99 

default FILEDEF commands issued by 

the assembler 36 
definitions for MOVEFILE command 139 
DEN option 99 
description 96 
DISK operand 97 
DISP option 99 
DSORG option 99 
DUMMY operand 97 
establishing file definitions for the 

STATE command 180 
examples 101,102 
KEYLEN option 98 
LIMCT option 98 
LOHCASE option 99 
LRECL option 98 
MEMBER option 99 
NOCHANGE option 98 
OPTCD option 99 
PERM option 98 
PRINTER operand 97 
PUNCH operand 97 
READER operand 97 
RECFM option 98 
TAPn operand 97 
TERMINAL operand 96 
TRTCH option 99 
UPCASE option 99 
when to use (OS users) 75 
when to use in CMS/DOS 71 
XTENT option 98 
7TRACK option 99 
9TRACK option 99 
definitions 

clearing 100 
displaying 157 
operand of CMS QUERY command 157 
fileid, in command syntax 15 
f ilemode 
changing 

FMODE subcommand 230 
with the COPYFILE command 47 
displaying, FMODE subcommand 230 
letter 

establishing 26 
replacing 162 
numbers 

changing 165 
2 27 
specifying, for FSWRITE macro 312 
specifying on READCARD command 160 
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filename 

changing, FNAME subcommand 231 
of an EXEC file 

testing 299,300 
files 

calculating blocksize 100 

calculating logical record length 100 

comparing 41 

copying 43 

creating from OS partitioned data sets 

139 
creating from OS tapes 197 
deleting from a CMS disk 88 
displaying 202 
dumping to tape 191 
erasing 88 

during program execution 307 
loading from tape 191 
modifying 43 

moving from device to device 139 
opening, during program execution 308 
overlaying 44 
printing 144 

in hexadecimal 144 
processed by TAPE command, listing 192 
punched 

restoring to disk 66,159 
punching to a virtual card punch 66,149 
relating to OS ddname 96 
renaming 164 

displaying new names for 164 
sorting records in 175 
tape, writing to disk 191 
verifying the existence of 180 
filetypes, reserved, default editor 

settings for 343 
filing, edited files on disk 229 
FILL option, of COPYFILE command 45 
FIND subcommand 

description 229 
effect of image setting 234 
first-in first-out stacking, in an EXEC 

procedure 281,293 
fixed-length file, converting to 
variable-length, using the RECFM 
subcommand 242 
fixed-length files, converting to 

variable-length 48 
FLAG option, of ASSEMBLE command 33 
FMODE 

option, of LISTFILE command 121 
subcommand, description 230 
fn ft fm, used for to represent file 

identifier 15 
FNAME 

option, of LISTFILE command 121 
subcommand, description 231 
FOR option, of COPYFILE command 44 
FORMAT 

command 

description 104 
examples 105 
LABEL option 104 
performance consideration 105 
RECOMP option 104 
option 

of LISTDS command 117 
of LISTFILE command 121 



subcommand 

description 231 
DISPLAY operand 232 
LINE operand 232 
formatting, CMS disks 104 
FORTRAN filetype, default editor settings 

343 
forward space a tape 191 
FORWARD subcommand, description 232 
FREE option, of LISTDS command 116 
FREEFORT filetype, default editor settings 

343 
FRLABEL option, of COPYFILE command 44 
FROM option 

of COPYFILE command 44 
of GENMOD command 108 
FSCB 

macro 

BUFFER operand 304 
description 304 
NOREC operand 304 
RECNO operand 304 
operand 

of FSCLOSE macro 306 
of FSERASE macro 307 
of FSOPEN macro 308 
of FSREAD macro 309 
of FSSTATE macro 311 
of FSWRITE macro 312 
FSCB (file system control block) 
creating 304 
format 305 
FSCBD macro, description 305 
FSCLOSE macro 

description 3 06 
ERROR operand 306 
FSCB operand 306 
FSERASE macro 

description 307 
ERROR operand 307 
FSCB operand 307 
FSF, tape control function 191 
FSOPEN macro 

description 308 
ERROR operand 308 
FSCB operand 308 
FSR, tape control function 191 
FSREAD macro 

description 3 09 
ERROR operand 309 
FSCB operand 309 
FSSTATE macro 

description 311 
ERROR operand 311 
FSCB operand 311 
FST (see file status table) 
FSWRITE macro 

description 312 
ERROR operand 312 
FSCB operand 312 



GEN operand 

of MACLIB command 135 
of TXTLIB command 200 

GENDIRT command, description 107 
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general registers 

changing, in the debug environment 273 

displaying, in the debug environment 
270 

generating list of EQU statements for 
334 

printing contents of 268 
generating 

macro libraries 135 

MODULE files 108 
GENHOD command 

ALL option 109 

description 108 

DOS option 109 

FROM option 108 

MAP option 108 

NOMAP option 108 

NOSTR option 109 

OS option 109 

STR option 109 

SYSTEM option 109 

TO option 108 
GETFILE subcommand, description 233 
global changes 

with the ALTER subcommand 220 

with the CHANGE subcommand 224 

with the OVERLAY subcommand 240 
GLOBAL command 

description 111 

DOSLIB operand 111 

MACLIB operand 111 

querying which DOSLIBs were last 
specified 158 

querying which MACLIBs were last 
specified 157 

querying which TXTLIBs were last 
specified 157 

TXTLIB operand 111 
GO subcommand, description 269 
GPR 

operand of SET subcommand 273 

subcommand, description 270 
GRAPHIC option, of DDR command TYPE/PRINT 
function control statement 60 



H 
halting 

execution of a CMS command 217 
recording of trace information 216 
terminal output 217 

in an EXEC procedure 293 
the CMS batch virtual machine 216 
HB Immediate command 216 
header 
card 

as a READ control card 159 
punched by the PUNCH command 149,150 
for LISTFILE command output 120 
format 122 
HEADER option 

of LISTFILE command 120 
of PUNCH command 149 
HEX option 

of DDR command TYPE/PRINT function 

control statement 60 
of PRINT command 144 
of TYPE command 202 



hexadecimal 
conversion 

in an assignment statement 278 
LINEDIT macro 320 
display a file in 202 
print a file in 144 
representations of characters, 

translating 171 
substitution 

in an EXEC procedure 278 
in an EXEC procedure, initializing 
287 
HNDEXT macro 

CLR operand 314 
description 314 
SET operand 314 
HNDINT macro 

ASAP operand 315 
CLR operand 315 
description 315 
ERROR operand 315 
SET operand 315 
used with WAITD macro 336 
HNDSVC macro 

CLR operand 316 
description 316 
ERROR operand 316 
SET operand 316 
HO Immediate command 216 
HT Immediate command 217 

stacking in an EXEC procedure 293 
HX 

DEBUG subcommand 270 
Immediate command 217 

effect on DLBL definitions 69 
effect on FILEDEF definitions 100 



ICS control statement (see Include Control 

Section (ICS) statement) 
ID card, CP, example 160 
identifying 

CMS/DOS phase libraries to search 111 
macro libraries to search 111 
TEXT libraries to search 111 
VSAM catalogs 77 
in CMS/DOS 73 
IEBPTPCH utility program, creating CMS 

files from tapes created by 197 
IEBUPDTE utility program, creating CMS 

files from tapes created by 197,198 
IEHMOVE utility program 

creating CMS files from tapes created by 

197 
creating CMS MACLIBs from tapes created 
by 195 
IGN operand of ASSGN command 37 

with DUMMY data sets 71 
ignore, logical unit assignment 37 
IJSYSCL, defining in CMS/DOS 71 
IJSYSCT 

defining 77 

in CMS/DOS 73 
IJSYSRL, defining in CMS/DOS 71 
IJSYSSL, defining in CMS/DOS 71 
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IJSYSUC 

defining 77 

in CHS/DOS 73 
image setting 

effect on FIND subcommand 229 

effect on logical tab settings 253 
IMAGE subcommand 

CANON operand 234 

description 234 

OFF operand 234 

ON operand 234 
Immediate commands 

HB 216 

HO 216 

HT 217 

HX 217 

RO 217 

RT 218 

SO 218 

summary 19 
IMPCP operand 

of CMS QUERY command 153 

of CMS SET command 172 
IMPEX operand 

of CMS QUERY command 153 

of CMS SET command 172 
implied 

CP function 53 

query the status of 153 
setting 172 

EXEC function 92 

query the status of 153 
setting 172 
INC option, of UPDATE command 205 
INCLUDE command 

AUTO option 114 

called to load files dynamically 304 

CLEAR option 113 

description 113 

DUP option 114 

effect on loader tables 171 

examples 115 

following a LOAD command 115 

identify TXTLIBs to be searched 111 

INV option 114 

LIBE option 114 

MAP option 114 

NOAUTO option 114 

NOCLEAR option 113 

NODUP option 114 

NOINV option 114 

NOLIBE option 114 

NOREP option 114 

NOTYPE option 114 

ORIGIN option 113 

REP option 114 

RESET option 113 

SAME option 114 

START option 114 

TYPE option 114 
Include Control Section (ICS) , loader 

control statement 130 
increment 

specifying for line-number editing 241 

specifying for sequence numbers in a 
file 250 
inhibiting, variable substitution in an 
EXEC procedure 298 



initializing 

arguments in an EXEC procedure 279 

CMS disks 104 

hexadecimal substitution in an EXEC 

procedure 287 
the CMS/DOS environment 173 
INMOVE, MOVEFILE command ddname 139 
INPUT 

control statement, for DDR command 55 
operand 

of CMS QUERY command 154 
of CMS SET command 171 
subcommand 

description 235 
effect of image setting 234 
on = subcommand line 247 
input mode 219 

during line-number editing 237 
entering 235,245 
leaving 219 
of CMS Editor 12 
INSERT control statement, for UPDATE 

command 207 
inserting 

lines in a file being edited 235 
records in a file with the UPDATE 
command 207 
instruction, addresses, halting program 

execution at 264 
instructions 
altering 

with LOAD command 132 
with the STORE subcommand 274 
Interactive Problem Control System (IPCS) 

11 
interrupts 

entering debug environment after 263 
handling 

external 314 
I/O 315 
SVC 316 
I/O, waiting 336 
INV option 

of INCLUDE command 114 
of LOAD command 126 
invalid, card images in a load map 127 
invoking 

a synonym table 186 
the CMS Editor 12 
I/O devices, handling interrupts for 315 
IPCS (Interactive Problem Control System) 

11 
issuing, error messages in an EXEC 280,284 



job catalog 

identifying 77 
in CMS/DOS 73 
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keyboard, unlock to enter commands 19 
KEYLEN option, of FILEDEF command 98 
keypunch characters, converting 45 
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LABEL option 

of FORMAT command 104 
of LISTFILE command 121 
labels 

for a file system control block, 

generating 305 
in an EXEC procedure 

object of &L00P control statement 

289 
using &C0NTIHUE 282 
in EXEC procedures, object of &G0T0 

control statement 287 
on CMS disks, writing 104 
language processors, using under CMS 11 
last-in first-out stacking, in an EXEC 

procedure 281,293 
LDRTBLS operand 

of CMS QUERY command 153 
of CMS SET command 171 
LDT statement (see Loader Terminate (LDT) 

statement) 
LEAVE option, of DDR command INPUT/OUTPUT 

control statement 56 
leaving 

CMS subset 246 
debug environment 

RETURN subcommand 272 
with the GO subcommand 269 
with the HX subcommand 270 
edit environment 

FILE subcommand 229 
QUIT subcommand 242 
EXEC procedure 286 
LEFT operand of LINEMODE subcommand 236 
length 

of a token in an EXEC procedure, 

determining 297 
specifying for LINEDIT macro 
substitution list 323 
LENGTH operand of RDTERM macro 333 
LIBE option 

of INCLUDE command 114 
of LOAD command 126 
LIBMAC option, of ASSEMBLE command 33 
libraries 

CMS (see also DOSLIB, MACLIB, TXTLIB) 
displaying member names 203 
displaying those to be searched 

during processing 157 
identifying 111 
macro libraries 135 
printing members 144 
querying 157 

used when processing CMS commands 
111 
DOS/VS 

assigning logical units 38 
obtain information about 84 
DOS/VS core image 

defining IJSYSCL 71 
fetching phases from 94 
DOS/VS procedure, copying procedures 

147 
DOS/VS relocatable 

assigning SYSRLB 166 
copying modules from 166 
defining IJSYSRL 71 



displaying modules from 166 
link -editing modules from 81 
printing modules from 166 
punching modules from 166 
DOS/VS source statement 
assigning SYSSLB 177 
copying books 177 
copying macros from 90 
defining IJSYSSL 71 
displaying books 177 
printing books 177 
punching books 177 
OS macro libraries (see macro 

libraries, OS) 
punching member files in 149 
LIBRARY 

loader control statement 129 
operand, of CMS QUERY command 157 
LIFO operand 

of &BEGSTACK control statement 281 
of 6STACK control statement 293 
LIMCT option, of FILEDEF command 98 
line 

image, of a record 234 
mode 

of the CMS Editor 87 
of 3270 232 
number, of an EXEC statement, testing 
301 
LINE operand of FORMAT subcommand 232 
LINECOUN option 

of ASSEMBLE command 33 
of PRINT command 145 
LINEDIT macro 

BUFFA operand 325 
COMP operand 319 
description 317 
DISP operand 324 
DOT operand 319 
MAXSUBS operand 326 
MF operand 326 
RENT operand 327 
SUB operand 320 

substitution list, specifying 320 
TEXT operand 318 
TEXTA operand 319 
LINEMODE subcommand 
description 236 
LEFT operand 236 
OFF operand 237 
RIGHT operand 236 
line-number editing 

inserting a single line 260 
left-handed 236 

reserializing records in a file 250 
right-handed 236 

setting a prompting increment for 241 
lines 

printing with the PRINTL macro 327 
punching with the PUNCHC macro 329 
LINK command, accessing disks after 27 
linkage editor control statements 
DOS/VS supported in CMS/DOS 82 
OS 

read by TXTLIB command 201 
reguired format for TXTLIB command 
201 
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link-editing 

in CMS/DOS 81 

modules from DOS/VS relocatable 
libraries 82 

TEXT files in storage 125 

TXTLIB members 201 
list form of the LINEDIT macro 326 
LIST option 

of ASSEMBLE command 33 

of OPTION command 142 
LISTDS command 

description 116 

examples 117 

EXTENT option 116 

FORMAT option 117 

FREE option 116 

PDS option 117 
LISTFILE command 

ALLOC option 121 

APPEND option 121 

DATE option 121 

description 120 

examples 121 

EXEC option 120 

FMODE option 121 

FNAME option 121 

FORMAT option 121 

HEADER option 120 

LABEL option 121 

NOHEADER option 120 
listing 

extents occupied by OS and DOS files 
116 

files processed by the TAPE command 192 
LISTING, filetype, default editor settings 

343 
listing 

free extents on OS and DOS disks 116 

information 

about CMS files 120 

about DOSLIB members 79 

about files on OS and DOS disks 116 

about MACLIB members 135 

about MODULE files 138 

members of an OS partitioned data set 
117 

names of TXTLIB members 200 

status of current logical unit 
assignments 123 
LISTING filetype 

created by Access Method Services 29 

created by the ASSEMBLE command 33 
controlling 33 

created by the ESERV program 90 

printing 144 
LISTIO command 

A operand 123 

ALL operand 123 

APPEND option 123 

description 123 

EXEC option 123 

PROG operand 123 

STAT option 123 

SYS operand 123 

SYSxxx operand 123 

UA operand 123 
LISTX option, of OPTION command 142 
literal values, using in an EXEC 298 



LOAD 

command 

AUTO option 126 

called to load files dynamically 304 

CLEAR option 125 

description 125 

DOP option 126,127 

duplicate CSECTs 127 

effect on loader tables 171 

executing a program using 126 

identify TXTLIBs to be searched 111 

INV option 126 

MAP option 126 

NOAUTO option 126 

NOCLEAR option 125 

NODUP option 126 

NOINV option 126 

NOLIBE option 126 

NOMAP option 126 

NOREP option 126 

NOTYPE option 126 

ORIGIN option 125 

REP option 126 

RESET option 125 

START option 126 

TYPE option 126 

used with GENMOD command 109 
operand 

of DISK command 66 

of TAPE command 191 
load map 

creating 127 

displaying at your terminal 126 
generated by the GENMOD command 108 
of a MODULE file, displaying 138 
replace card image in 114 
load module, creating a map of 114 
load point of a file, specifying 125 
loader 

CMS 127 

control statements 

ENTRY statement 129 

Include Control Section (ICS) 
statement 130 

LIBRARY statement 129 

Loader Terminate (LDT) statement 130 

Replace (REP) statement 132 

Set Location Counter (SLC) statement 
131 
search order, for unresolved references 

128 
tables 

defining storage for 171 

displaying the number of 153 
Loader Terminate (LDT) , loader control 

statement 130 
loading 

CMS files dumped with the DISK DUMP 

command 66 
CMS files from tape 191 
MODULE files 134 

phases into storage for execution 94 
programs into storage 

INCLUDE command 113 

while using the editor 226 
TEXT files into storage, dynamically 
during program execution 304 
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TEXT files into storage for execution 
113, 125 
LOADMOD command 

called to load files dynamically 304 

CMS/DOS considerations 134 

description 134 
LOCATE subcommand 

description 238 

effect of zone setting 258 
logical, operators, in an EXEC procedure 

288 
logical record length, of a CMS file, 

defaults used by the CMS Editor 87 
logical units 

assigning 37 

listing 123 
long, form of editor's error message 238 
LONG subcommand, description 238 
looping, in an EXEC procedure 289 
LOWCASE option 

of ASSGN command 38 

of COPYFILE command 45 

of FILEDEF command 99 
lowercase letters 

converting to uppercase 45 

meaning in command format box 15 

suppressing translation to uppercase 
223 

translating to uppercase 
using the editor 223 
with the PRINT command 144 
LRECL option 

of COPYFILE command 45 
example 48 

of FILEDEF command 98 

of the EDIT command 87 
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M operand, of CASE subcommand 223 

MACLIB 

command 

ADD operand 135 

COMP operand 135 

DEL operand 135 

description 135 

DISK option 136 

GEN operand 135 

MAP operand 135 

PRINT option 136 

reading files created by the ESERV 

program 91 
REP operand 135 
TERM option 135 
files 

creating 135 

distributed with the CMS system 136 

identifying for assembly or 

compilation 111 
which MACLIBs will be searched 157 
operand 

of CMS QUERY command 157 
of GLOBAL command 111 
MACRO 

files, created by the ESERV program 90 
f iletype 

adding to MACLIBs 136 



default editor settings 343 
invalid records in, handling by 
MACLIB command 136 
macro definitions 

in an assembler listing 33 
in MACRO files 136 
macro libraries 
CMS 

adding to 135 

compacting members of 135 

creating 135 

deleting members of 135 

displaying information about members 

in 135 
replacing members of 135 
creating, from tapes created by IEHMOVE 

utility program 195 
DOS/VS, copying macros from 90 
identifying 111 
identifying for assembly 36 
OS 

concatenating 99 
using in CMS 36 
MAP 

filetype 

created by DOSLIB command 79 
created by DSERV command 84 
created by MACLIB command 135 
created by the LOAD command 127 
created by the TAPE command 192 
created by TXTLIB command 200 
operand 

of DOSLIB command 79 
of MACLIB command 135 
of TXTLIB command 200 
option 

of GENMOD command 108 
of INCLUDE command 114 
of LOAD command 126 
maps 

created by DOSLIB command 79 
created by the GENMOD command 108 
created by the LOAD command 127 
created by the MACLIB command 135 
created by TXTLIB command 200 
linkage editor, in CMS/DOS 81 
margins, setting left margin for input with 

the editor 253 
master catalog (VSAM) 
identifying 77 
identifying in CMS/DOS 73 
master file directory 
contents of 27 
suppress updating after RENAME command 

165 
updating entries in 164 
writing on disk 162 
MAXTEN option, TAPPDS command 198 
MAXUBS operand, of LINEDIT macro 326 
MCALL option, of ASSEMBLE command 33 
MEMBER option 

of FILEDEF command 99 
of PRINT command 144 
of PUNCH command 149 
of TYPE command 203 
MEMO filetype, default editor settings 343 
message, text for LINEDIT macro 318 
MF operand, of LINEDIT macro 326 



Index 



367 



minidisks (see also disks) 
copying 54 

counting cylinders on 104 
dumping to tape devices 54 
minimum abbreviation for commands, 

controlling 153,172 
MLOGIC option, of ASSEMBLE command 33 
MODE 

operand 

of RDTAPE macro 331 
of TAPECTL macro 335 
of WRTAPE macro 337 
option, of DDR command INPUT/OUTPUT 
control statement 56 
mode letter (see filemode letter) 
MQDESET operand, of TAPE command 191 
MODMAP command, description 138 
MODULE files 

creating 108 

defining synonyms for 186 

executing, with the RUN command 168 

format 108 

generating 108 

loading dynamically during program 

execution 304 
loading into storage for execution 134 
mapping 138 
modules, DOS/VS relocatable, link-editing 

81 
MOVEFILE command 

default device attributes 140 
description 139 
examples 139 
PDS option 139 
moving 

data from one device to another 139 
lines in a file being edited 262 
MSG, operand of &C0NTR0L control statement 

283 
MULT, option of DLBL command 69 
multilevel updates using the UPDATE 

command, examples of 212 
multiple 

extents for VSAM files 
specifying 76 
specifying in CMS/DOS 72 
FSCBs 305 
input files 

for the UPDATE command 205 
with the COPYFILE command 47 
output files 

with the COPYFILE command 43,47,49 
with the RENAME command 165 
substitution lists, LINEDIT macro 324 
multivolume VSAM extents 

identifying with the DLBL command 76 

in CMS/DOS 72 
maximum number of disks 76 

in CMS/DOS 73 
rules for specifying 76 
in CMS/DOS 73 



N 
nesting 

&IF statements in an EXEC procedure 288 

EXEC procedures 



passing variable data 301 
testing recursion level 300 

loops in an EXEC procedure 290 
never-call function, specifying in CMS TEXT 

file 129 
NEHDATE option, of COPYFILE command 44 
NEHFILE option, of COPYFILE command 44 
NEXT subcommand, description 239 
nnnnn subcommand, description 260 
NOALIGN option, of ASSEMBLE command 35 
NOALOGIC option, of ASSEMBLE command 33 
NOAUTO option 

LOAD command 126 

of INCLUDE command 114 
NOCC option, of PRINT command 144 
NOCHANGE option 

of DLBL command 69 

of FILEDEF command 98 
NOCLEAR option 

of INCLUDE command 113 

of LOAD command 125 
N0C0L1 option, of TAPPDS command 198 
NOCTL option, of UPDATE command 205 
NODECK option 

of ASSEMBLE command 34 

of OPTION command 142 
NODISK option, of ACCESS command 26 
NODISP option 

of EDIT command 87 

effect on FORMAT subcommand 232 
NODUMP option, of OPTION command 142 
NODUP option 

of INCLUDE command 114 

of LOAD command 126 
NOEND option, of TAPPDS command 198 
NOERRS, option, of OPTION command 142 
NOESD option, of ASSEMBLE command 33 
NOHEADER option 

of LISTFILE command 120 

of PUNCH command 149 
NOINC option, of UPDATE command 205 
NOINV option 

of INCLUDE command 114 

of LOAD command 126 
NOLIBE option 

of INCLUDE command 114 

of LOAD command 126 
NOLIBMAC option, of ASSEMBLE command 33 
NOLIST option 

of ASSEMBLE command 33 

of OPTION command 142 
NOLISTX option, of OPTION command 142 
NOMAP option 

GENMOD command 108 

of LOAD command 126 
NOMAXTEN option, of TAPPDS command 198 
NOMCALL option, of ASSEMBLE command 33 
NOMLOGIC option, of ASSEMBLE command 33 
NOMSG, operand of &CONTROL control 

statement 283 
nonrelocatable, modules, in CMS 108 
NONSHARE operand, of CMS SET command 173 
nonshared copy 

of a named system, obtaining 173 

of saved system, obtained during debug 
265 
NONUM option, of ASSEMBLE command 34 
NOOBJECT option, of ASSEMBLE command 34 
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NOPACK, operand of &CONTROL control 

statement 283 
NOPDS option, of TAPPDS command 197 
NOPRINT option 

of ASSEMBLE command 34 

of TAPE command 192 
NOPROF option, of ACCESS command 26 
NOPROMPT option, of COPYFILE command 44 
NOREC operand, of FSCB macro 304 
NORENT option, ASSEMBLE command 35 
HOREP option 

of INCLUDE command 114 

of LOAD command 126 

of UPDATE command 204 
NORLD option, of ASSEMBLE command 33 
NOSEQ8 option, of UPDATE command 205 
NOSPECS option, of COPYFILE command 44 
NOSTD option, of SYNONYM command 186 
NOSTK option 

of UPDATE command 205 

UPDATE command 212 
NOSTMT option, of ASSEMBLE command 34 
NOSTOR option, of UPDATE command 205 
NOSTR option, of GENMOD command 109 
NOSYM option, of OPTION command 142 
notational conventions 14 
NOTERM option 

of ASSEMBLE command 35 

of UPDATE command 205 
NOTEST option, of ASSEMBLE command 34 
NOTIME, operand of &CONTROL control 

statement 283 
NOTRUNC option, of COPYFILE command 45 
NOTYPE option 

of COPYFILE command 44 

of ERASE command 88 

of INCLUDE command 114 

of LOAD command 126 

of RENAME command 164 
NOUPDIRT option, of the RENAME command 164 
NOWTM option, of the TAPE command 192 
NOXREF option 

of ASSEMBLE command 34 

of OPTION command 142 
NOYFLAG option, of ASSEMBLE command 35 
nucleus 

CMS, protected storage 172 

protection against writing over 172 

protection feature, displaying status of 
154 

resident commands, list 17 
null 

arguments in an EXEC procedure, setting 
with % 299 

symbols in an EXEC statement 289 
null line 

stacking, in an EXEC 293 

stacking in the console stack 251 

to return to edit mode from input mode 
219 

when entering VSAM extents 76 
in CMS/DOS 72 
NUM, result of &DATATYPE built-in function 

297 
number 

of characters in a token in an EXEC 
procedure, determining 297 



of records to be read or written, 
specifying 304 
NUMBER option, of ASSEMBLE command 34 
numbering 

records in a file being edited, SERIAL 

subcommand 249 
records in a source file with the UPDATE 
command 204 
numeric 

data, determining if a token contains 

297 
variables in an EXEC procedure 299 





object deck, assembler, generating 34 

OBJECT option, of ASSEMBLE command 34 

OFF 

operand 

of &CONTROL control statement 283 
of SHEX control statement 287 
of &TIME control statement 294 
of AUTOSAVE subcommand 221 
of IMAGE subcommand 234 
of LINEMODE subcommand 237 
of SERIAL subcommand 249 
OLDATE option, of COPYFILE command 44 
ON 

operand 

of &HEX control statement 287 
of STIME control statement 294 
of IMAGE subcommand 234 
of SERIAL subcommand 250 
opening, CMS files, during program 

execution 308 
operands, command 13 
operators, comparison, in an EXEC procedure 

288 
OPTCD option, of FILEDEF command 99 
OPTION 

command 

DECK option 142 
description 142 
DUMP option 142 
ERRS option 142 
LIST option 142 
LISTX option 142 
NODECK option 142 
NODUMP option 142 
NOERRS option 142 
NOLIST option 142 
NOLISTX option 142 
NOSYM option 142 
NOXREF option 142 
SYM option 142 
XREF option 142 
48C option 142 
60C option 142 
operand of CMS QUERY command 158 
options 

command 13 

for the DOS/VS COBOL compiler, 

specifying 142 
for the DOS/VS COBOL compiler in 

CMS/DOS, guerying 158 
LOAD and INCLUDE command, retaining 114 
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origin 

for debug environment 
setting 271 

used to compute symbol location 267 
ORIGIN 
option 

of FETCH command 94 
of INCLUDE command 113 
of LOAD command 125 
subcommand, description 271 
OS 

data sets 

defining in CMS 96 
listing information 116 
disks, accessing 28 
linkage editor control cards, adding to 

TEXT files 201 
macro libraries, used in assembly 36 
option of GENMOD command 109 
partitioned data sets (see partitioned 

data sets) 
tapes, containing partitioned data sets 

197 
utility programs 

creating CMS files from tapes created 

by 197 
IEBPTPCH 197 
IEBUPDTE 197 
IEHMOVE 197 
OUTMOVE, MOVEFILE command ddname 139 
OUTPUT 

control statement, for DDR command 55 
operand 

of CMS QUERY command 154 
of CMS SET command 171 
OVERLAY subcommand 
description 240 
effect of image setting 234 
overlaying 

character strings 240 

columns of data in a file, with the 

COPYFILE command 50 
data in a file 

specifying number of lines to overlay 

244 
with the COPYFILE command 44 
with the OVERLAY subcommand 240 
files 44 
OVLY option 

of COPYFILE command 44 
example 50 



P 
PACK 

operand of &CONTROL control statement 

283 
option 

of COPYFILE command 45 
of COPYFILE command, example 49 
packing 

CMS files 45 

specifying a fill character 49 
execution summary of an EXEC 283 
parameter list 

displaying with the LINEDIT macro 323 
passed by START command 179 



passed by the RUN command 169 
passed to an SVC instruction, recorded 
182 
parent disk, of read-only extension 26 
parentheses 

before an option list 13 
scanned by EXEC interpreter 279 
partition size, for CMS/DOS, setting 173 
partitioned data sets 

copying into CMS files 139 
displaying member names 119 
on tapes, creating CMS files 197 
passing 

arguments, to nested EXEC procedures 

301 
control in an EXEC procedure 
&GOTO control statement 287 
SSKIP control statement 292 
PD operand of DSERV command 84 
PDS (see partitioned data sets) 
PDS option 

of LISTDS command 117 
of MOVEFILE command 139 
of TAPPDS command 197 
periods 

as concatenation character for EXEC 

variables 289 
indicating message substitution in 

LINEDIT macro 318 
placing at end of message text in 
LINEDIT macro 319 
PERM option 

of DLBL command 69 
of FILEDEF command 98 
permanent file definitions 98 
phase library, CMS/DOS 79 
phases 

executing in CMS/DOS 94 
in DOS/VS core image libraries, 
obtaining information about 85 
PLI filetype, default editor settings 343 
PLIOPT filetype, default editor settings 

343 
positioning 

current line pointer 

at top-of-file (TOP subcommand) 253 
BACKWARD subcommand 222 
based on character string 238 
BOTTOM subcommand 222 
DOWN subcommand 227 
FIND subcommand 229 
FORWARD subcommand 232 
NEXT subcommand 239 
nnnnn subcommand 260 
UP subcommand 255 
read/write pointer 

FILEDEF command 99 
FSWRITE macro 313 
tapes 191 

TAPECTL macro 334 
prefixes 

identifying sets of files 

with the ACCESS command 27 
with the LISTFILE command 121 
prefixing, error messages issued in EXEC 

with DMS 280,284 
PRESERVE subcommand, description 241 
preserving, settings for the editor 241 
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PRINT 

command 

CC option 144 
description 144 
HEX option 144 
LINECOUN option 145 
MEMBER option 144 
NOCC option 144 
function statement of DDR command 59 
option 

of AMSERV command 29 
of ASSEMBLE command 34 
of DOSLIB command 79 
of DOSLKED command 81 
of DSERV command 84 
of HACLIB command 136 
of PSERV command 147 
of RSERV command 166 
of SSERV command 177 
of TAPE command 192 
of TXTLIB command 200 
of UPDATE command 205 
printer, virtual, closing after using 

PRINTL macro 328 
PRINTER operand 

of ASSGN command 37 
of FILEDEF command 97 
printing 

CMS files 144 

specifying number of lines per page 
145 
CMS files in hexadecimal format 144 
contents of general registers, from 

debug environment 268 
contents of virtual storage 268 
hexadecimal listing of a file 144 
lines 

with the LINEDIT macro 324 
with the PRINTL macro 327 
list of CMS files on a tape 192 
members of CMS libraries 144 
procedures from a DOS/VS procedure 

library 147 
records 

at the printer 54 
at the terminal 54 
PRINTL macro 

description 327 
ERROR operand 327 
private libraries (see libraries, DOS/VS) 
PROC files, creating in CMS/DOS 147 
procedure libraries, DOS/VS, displaying the 

directories of 84 
procedures, DOS/VS, copying into CMS files 

147 
PROFILE EXEC, suppressing execution of 26 
PROG operand of LISTIO command 123 
program 

entry point, specifying 125 

entry point selection, during CMS loader 

processing 127 
execution 

displaying data at the terminal 317 

displaying parameter lists 323 

displaying storage 322 

halting 217,264 

handling external interrupts 314 

handling I/O interrupts 315 



handling SVC interrupts 316 
in CMS subset 226 
in CMS/DOS 94 

modifying control words 273 
modifying general registers 273 
modifying storage 274 
resuming after a breakpoint 269 
with the LOAD command 126 
with the START command 179 
Program Status Word (see PSW (Program 

Status Word)) 
programmer logical units 
for job catalogs 73 

listing assignments for in CMS/DOS 123 
valid assignments in CMS/DOS 37 
PROMPT 

option, of COPYFILE command 44 
subcommand, description 241 
prompting 

increment for line- number editing 237 
setting 241 
PROTECT operand 

of CMS QUERY command 154 
of CMS SET command 172 
protecting 

against writing on nucleus 172 
data in a file during an edit session 
258 
PSERV command 

description 147 
DISK option 147 
PRINT option 147 
PUNCH option 147 
TERM option 147 
PSW 

operand of SET subcommand 273 
subcommand, description 272 
PSW (Program Status Word) 

changing, in the debug environment 273 
displaying in the debug environment 272 
PUNCH 

assembler punch output ddname 36 
command 

description 149 
HEADER card format 150 
HEADER option 149 
MEMBER option 149 
NOHEADER option 149 
operand 

of ASSGN command 37 
of FILEDEF command 97 
option 

of PSERV command 147 
of RSERV command 166 
of SSERV command 177 
punch, virtual, closing after PUNCHC macro 

329 
PUNCHC macro 

description 329 
ERROR operand 329 
punched files, restoring to disk 66 
punching 

CMS files to the virtual card punch 149 
CMS files to the virtual punch 66 
header card 149 
lines in an EXEC procedure, SPUNCH 

control statement 290 
lines with the PUNCHC macro 329 
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members of CMS libraries 149 
procedure from a DOS/VS procedure 

library 147 
statements in an EXEC, SBEGPUNCH control 

statement 281 



V 

QUERY command (CMS) 

ABBREV operand 153 

BLIP operand 152 

description 152 

DISK operand 155 

DLBL operand 157 

DOS operand 158 

DOSLIB operand 158 

DOSPART operand 158 

FILEDEF operand 157 

IMPCP operand 153 

IMPEX operand 153 

INPUT operand 154 

LDRTBLS operand 153 

LIBRARY operand 157 

MACLIB operand 157 

OPTION operand 158 

OUTPUT operand 154 

PROTECT operand 154 

RDYMSG operand 153 

REDTYPE operand 154 

RELPAGE operand 153 

SEARCH operand 155 

SYNONYM ALL operand 156 

SYNONYM SYSTEM operand 156 

SYNONYM USER operand 156 

SYSNAMES operand 154 

TXTLIB operand 157 

UPSI operand 158 
QUIT subcommand, description 242 



R 

RD operand of DSERV command 84 

RDCARD macro 

description 330 

ERROR operand 330 
RDTAPE macro 

description 331 

ERROR operand 331 

MODE operand 331 
RDTERM macro 

ATTREST operand 333 

description 332 

EDIT operand 332 

LENGTH operand 333 
RDYMSG operand 

CMS SET command 171 

of CMS QUERY command 153 
read, console read after CMS command 

execution 172 
READ control card 159 

deleting 160 

format 160 
READCARD command, description 159 
reader, virtual, read a file from 159 
READER operand 

of ASSGN command 37 

of FILEDEF command 97 



reading 

CMS files 

during program execution 309 
from the virtual card reader 66 
sequentially 310 
from the terminal 

during EXEC processing 291 
RDTERM macro 332 
lines from the console stack 251 
OS macro libraries into CMS MACLIBs 195 
records from a virtual card reader 159 

RDCARD macro 330 
records from tape, RDTAPE macro 331 
tape files created by OS utility 

programs 197 
variable symbols from the terminal 
during EXEC processing 291 
read-only 

disks, editing files on 221 
extensions 

editing files on 86 
releasing 162 
read/write 

status of disks 
controlling 27 
finding the first read/write disk in 

the standard search order 300 
finding the read/write disk with the 

most space 300 
listing for disk assignments in 

CMS/DOS 123 
querying 155 
Ready message 

displaying return code from EXEC 

processing 286 
format 171 
long form 171 
query the setting of 153 
setting 171 
short form 171 
special format in EXEC 92 
RECFM 

operand, of FSCB macro 304 
option 

of COPYFILE command 45 
of COPYFILE command, examples 48 
of FILEDEF command 98 
subcommand 

description 242 
F operand 242 
V operand 242 
RECNO operand, of FSCB macro 304 
RECOMP option, of FORMAT command 104 
record format 
of a CMS file 

changing 45,48 
listing 121 
of a file, specifying 98 
records that can be punched 150 
specifying, for FSHRITE macro 312 
record length 

default used by the CMS Editor 87 
modifying 87 
of a CMS file 

changing 45,48 
listing 121 

maximum lengths for the PRINT command 
145 
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specifying truncation setting for input 

254 
specifying with FILEDEF command 100 
record number, specifying next record to be 

accessed 304 
recording 

information about supervisor calls in 

your virtual machine 182 
technique for a tape, specifying 192 
trace information for SVC instructions 
182 

halting 216 
records 

displaying selected positions of 202 
in a file, numbering with the UPDATE 
command 204 
red type 

display lines with WRTERM macro 339 
for error messages 172 
REDTYPE operand 

of CMS QUERY command 154 
of CMS SET command 172 
reentrant code, for LINEDIT macro 

instruction 326 
re-executing 

EDIT subcommands 246 
X/Y subcommands 257 
references 
unresolved 

resolving with INCLUDE command 114 
resolving with LOAD command 126 
REGEQU macro, description 333 
registers (see general registers) 
relating, an OS ddname to a CMS file 96 
RELEASE command 

description 162 
DET option 162 
releasing 

disks 162 

effect on logical unit assignments in 

CMS/DOS 38 
in CMS/DOS 162 

when DLBL definitions are active 75 
page frames from storage 171 

after command execution 153 
read-only extensions 162 
relocatable 

libraries (DOS/VS) , displaying the 

directories of 84 
modules, link-editing in CMS/DOS 81 
relocation dictionary, assembler 33 
RELPAGE operand 

of CMS QUERY command 153 
of CMS SET command 171 
Remote Spooling Communications Subsystem 

(RSCS) 11 
remote 3270 terminals, using the CMS Editor 

232 
RENAME command 

description 164 
NOTYPE option 164 
NOUPDIRT option 164 
TYPE option 164 
UPDIRT option 164 
renaming, CMS files 164 
RENT 

operand, LINEDIT macro 327 
option, ASSEMBLE command 35 



RENUM subcommand, description 243 
renumbering 

records in a file, SERIAL subcommand 

249 
statements in VSBASIC and FREEFORT files 
243 
REP 

operand, of MACLIB command 135 
option 

of INCLUDE command 114 
of LOAD command 126 
of UPDATE command 204 
REPEAT subcommand 244 

used with OVERLAY subcommand 240 
repeating 

EDIT subcommands 246 
X/Y subcommands 257 
REPLACE 

control statement, for UPDATE command 

208 
option, of COPYFILE command 44 
subcommand 

description 245 
effect of image setting 234 
restriction while using line-number 
editing 237 
Replace (REP) 

loader control statement 132 
image of in a load map 114 
replacing 

a source file 204 
an old file with a new copy 44 
members in macro libraries 135 
records in a file 208 
records in a file being edited 245 
RESET 

operand of &TIME control statement 294 
option 

of INCLUDE command 113 
of LOAD command 125 
resetting 

execution starting point 113 
the number of cylinders on a virtual 
disk 104 
resolving, unresolved references, with the 

LOAD command 126 
responses, CMS Editor, controlling format 

of 238 
RESTORE 

function statement, of DDR command 57 
subcommand, description 245 
restoring 

CMS files punched with the DISK DUMP 
command 66 

dumped files on disk 191 
files to disk from tape 54 
settings of EDIT subcommands 245 
terminal output 218 
restrictions 

Access Method Services and VSAM 
DOS/VS users 345 
OS/VS users 347 
resuming 

program execution, in the debug 

environment 269 
terminal output, in an EXEC procedure 

293 
tracing 217 
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RETURN 

command, description 246 

subcommand (DEBUG) 272 
return codes 

CMS, in an EXEC procedure 92 

displaying during EXEC processing 283 

from Access Method Services 30 

from CMS commands, testing in an EXEC 
procedure 301 

from CMS macro instructions 303 

from the EXEC interpreter 93 

specifying in an EXEC procedure 286 

-1 53 
REUSE subcommand (see also == subcommand) 

description 246 

examples 246 
REM, tape control function 191 
rewind, a tape 191 
REWIND option, of DDR command INPUT/OUTPUT 

control statement 56 
ribbon, two-color, controlling use of 154 
RIGHT operand of LINEMODE subcommand 236 
RLD option, of ASSEMBLE command 33 
RO Immediate command 217 
RSCS (Remote Spooling Communications 

Subsystem) 11 
RSERV command 

description 166 

DISK option 166 

PRINT option 166 

PUNCH option 166 

TERM option 166 
RT Immediate command 218 

stacking in an EXEC procedure 293 
RUN 

command, description 168 

tape control function 191 



SAME option, of INCLUDE command 114 
SAVE subcommand, description 248 
saved system names 

guerying 154 

setting 172 
saving 

CMS files on disk, during an edit 
session 248 

files during an edit session, 
automatically 221 

mindisks on tape 54 
SCAN operand, of TAPE command 191 
scanning 

&ERROR control statement 285 

contents of a CMS file 248 

in an EXEC procedure 279 

the contents of a CMS tape 191 
SCRIPT 

files 

CASE setting 223 

default image setting 234 

filetype,, default editor settings 343 
SCROLL subcommand, description 248 
SCROLLUP subcommand, description 248 
SD operand of DSERV command 84 
S-disk, accessed after IPLing CMS 27 
SEARCH operand, of CMS QUERY command 155 



search order 

for CMS commands 16 
for executable phases in CMS/DOS 94 
for relocatable modules in CMS/DOS 82 
for the CMS loader 127,128 
of CMS disks, guerying 155 
searching, TXTLIB files for unresolved 

references 114 
SEQUENCE control statement, for UPDATE 

command 206 
seguence numbers 

assigned to VSAM extents 76 
in CMS/DOS 7 2 
seguencing records in a source file 
using the Editor 250 
with the UPDATE command 204 
SEQ8 option, of UPDATE command 204 
SERIAL subcommand 
ALL operand 250 
description 249 
OFF operand 249 
ON operand 250 
serializing 

records in a file 249 

when line-number editing is in effect 

250 
with the UPDATE command 204 
SET 

command (CMS) 

ABBREV option 172 

AUTOREAD option 172 

BLIP option 170 

description 170 

determining status of SET operands 

for virtual machine environment 152 
DOS operand 173 
DOSPART operand 173 
IMPCP option 172 
IMPEX option 1,72 
INPUT option 171 
LDRTBLS option 171 
NONSHARE operand 173 
OUTPUT option 171 
PROTECT option 172 
RDYMSG operand 171 
REDTYPE option 172 
RELPAGE option 171 
UPSI operand 173 
operand 

of HNDEXT macro 314 
of HNDINT macro 315 
of HNDSVC macro 316 
subcommand (DEBUG) 273 
CAW operand 273 
CSW operand 273 
GPR operand 273 
PSW operand 273 
Set Location Counter (SLC) , loader control 

statement 131 
setting 

automatic read function 172 

the blip characters fcr your virtual 

machine 170 
the load point for execution 113 
the number of loader tables 171 
sharing 

disks, read/write 27 
saved systems 172 
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short form, of the editor error message 

251 
SHORT subcommand, description 251 
SKIP 

operand, of TAPE command 191 
option, of DDR command INPUT/OUTPUT 
control statement 56 
skipping, lines in an EXEC procedure 292 
SLC statement (see Set Location Counter 

(SLC) statement) 
SO Immediate command 218 
SORT 

command 

description 175 
storage requirements 175 
option of DSERV command 84 
sort fields, defining 175 
sorting 

directories of DOS/VS libraries 84 
the user file directory 162 
source files 

for the assembler 32 
replacing 204 
source statement libraries, DOS/VS, 

displaying the directories of 84 
source symbol table, assembler, generating 

34 
space, determine free extents for VSAM 116 
special variables (see EXEC special 

variables) 
specification list, for COPYFILE command, 

format 49 
specifying 

carriage control characters, for PRINT 

command 144 
substitution list for LINEDIT macro 320 
SPECS option of COPYFILE command 44 

usage 49 
SPOOL command 

used with DISK DUMP command 66 
used with PRINT command 145 
SSERV command 

description 177 
DISK option 177 
PRINT option 177 
PUNCH option 177 
TERM option 177 
STACK 

subcommand, description 251 
value of 8READFLAG special variable 301 
stacking 

commands in the console buffer 19 

EDIT subcommands 246,251 

in an EXEC procedure, testing whether 

there are lines in the stack 301 
lines in the console stack 

6BEGSTACK control statement 281 
&STACK control statement 293 
meaning in command format box 15 
START 

command 

description 179 
passing arguments 179 
option 

of FETCH command 94 
of INCLUDE command 114 
of LOAD command 126 



starting 

program execution 179 
program execution in CMS/DOS 94 
starting point for execution of a module, 

setting 125 
STAT option, of LISTIO command 123 
STATE command, description 180 
STATEW command, description 180 
status of virtual machine environment 152 
STD option, of SYNONYM command 186 
STK option 

of UPDATE command 205 
UPDATE command 212 
STMT option, of ASSEMBLE command 34 
stopping, execution of a program or command 

217 
STOR option, of UPDATE command 205 
storage 

clearing to zeros 125 

in CMS/DOS 83 
displaying with the LINEDIT macro 322 
examining in debug environment 275 
initializing for MODULE file execution 

109 
modifying during program execution 274 
releasing pages of after command 

execution 153,171 
requirements for the SORT command 175 
specifying storage for a CMS/DOS 

partition 173 
used by GETFILE subcommand 233 
STORE subcommand, description 274 
storing, data into virtual storage 

locations 274 
STR option, of GENMOD command 109 
SUB operand of LINEDIT macro 320 
sublibraries, of DOS/VS source statement, 

copying books 177 
subset, CMS (see CMS subset) 
substituting 

message text in a LINEDIT macro 318 
variable symbols in an EXEC procedure 
278 
substitution 

in an EXEC procedure, inhibiting 298 
list for LINEDIT macro 320 
specifying length 323 
substrings, extracting in an EXEC 

procedure, &SUBSTR built-in function 298 
summary, of CMS commands 20 
suppressing 

display of long form of editor error 

message 251 
FILE NOT FOUND error message during EXEC 

processing 283 
hexadecimal substitution in an EXEC 

procedure 287 
terminal output, in an EXEC procedure 

293 
translation of lowercase letters to 
uppercase 223 
suspending trace recording 182,218 
SVC instructions 

handling interrupts during program 

execution 316 
tracing 182 
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SVCTRACE command 
description 182 
output 185 
SYM option, of OPTION command 142 
symbol table, debug 267 
symbolic names, assigning to storage 

locations, in the debug environment 267 
symbols 
debug 

defining 267 
modifying 274 

used to set breakpoints 264 
in an EXEC procedure 

effect of undefined in &IF statement 

289 
reading from the terminal or console 
stack 291 
substituted in an EXEC procedure, 

displaying 283 
variable (see variable symbols) 
SYNAMES operand, of CMS QUERY command 154 
SYNONYM 
command 

CLEAR option 186 

description 186 

example 187 

NOSTD option 186 

relationship to SET ABBREV command 

189 
STD option 186 
operand, of CMS QUERY command 156 
SYNONYM ALL operand, of CMS QUERY command 

156 
SYNONYM SYSTEM operand, of CMS QUERY 

command 156 
synonym table 
clearing 186 
defining 187 

format for entries in 187 
invoking 186 
SYNONYM USER operand, of CMS QUERY command 

156 
synonyms 

for CMS and user-written commands 186 
displaying 156 
examples 187 
system, displaying 156 
synonyms for CMS and user-written commands, 

displaying 188 
synonyms for user-written and CMS commands, 

defining 187 
SYS operand of LISTIO command 123 
SYSCAT, assign in CMS/DOS 73 
SYSIN 

assembler input 36 

logical unit assignment in CMS/DOS 38 
SYSIPT, assigning for the ESERV program 90 
SYSLOG, assigning in CMS/DOS 38 
SYSNAME operand, of CMS SET command 172 
SYSPARM option, ASSEMBLE command 35 
SYSPRINT control statement of DDR command 

56 
SYSRES, assigning in CMS/DOS 38 
system and programmer logical units, 

entering on DLBL command 70 
system disk 

files available 27 
releasing 162 



system logical units 

invalid assignments in CMS/DOS 38 
listing assignments for in CMS/DOS 123 
valid assignments in CMS/DOS 37 
SYSTEM option, GENMOD command 109 
system residence volume, DOS/VS, specifying 

173 
SYSTERM, option, ASSEMBLE command 34 
SYSxxx 

operand 

of ASSGN command 37 
of LISTIO command 123 
option of DLBL command 69 



T 
tab 

characters, how the editor handles 234 
settings, used by the editor 252 
TABSET subcommand 

affected by IMAGE subcommand 234 
description 252 
tape 

control functions 191 

restrictions when using 193 

TAPECTL macro 334 
files 

created by OS utility programs 197 

created by TAPE command 193 

writing to disk 191 
marks 

writing 191,192 
recording technigue, specifying 192 
TAPE command 

control functions 

BSF 191 

BSR 191 

ERG 191 

FSF 191 

FSR 191 

REN 191 

RUN 191 

HTM 191 
DEN option 192 
description 190 
DISK option 192 
DUMP operand 191 
EOF option 192 
EOT option 192 
LOAD operand 191 
MODESET operand 191 
NOPRINT option 192 
NOWTM option 192 
PRINT option 192 
SCAN operand 191 
SKIP operand 191 
TAPn option 192 
TERM option 192 
TRTCH option 192 
WTM option 192 
7TRACK option, 192 
9TRACK option 192 
TAPECTL macro 

description 334 
ERROR operand 335 
MODE operand 335 
TAPEMAC command, description 195 
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tapes 

assigning to logical units in CMS/DOS 

38 
controlling, TAPECTL macro 334 
creating CMS disk files 197 
density of, specifying 192 
displaying the filenames on 191 
dumping and loading CHS files 190 
dumping and restoring disk data 54 
positioning 191 

at a specified file 191 

TAPECTL macro 334 
reading records from, RDTAPE macro 331 
used for AHSERV input and output 29 

entering ddnames 30 

in CMS/DOS 30 
writing records to, WRTAPE macro 337 
writing tape marks on 192 
TAPIN option, of AMSERV command 29 
TAPn 

operand 

of ASSGN command 37 

of FILEDEF command 97 
option 

of TAPE command 192 

TAPPDS command 198 
TAPOUT option, of AMSERV command 29 
TAPPDS command 

COL1 option 198 
description 197 
END option 198 
MAXTEN option 198 
N0C0L1 option 198 
NOEND option 198 
NOMAXTEN option 198 
NOPDS option 197 
PDS option 197 
TAPn option 198 
UPDATE option 198 
TD operand of DSERV command 84 
TERM 

option 

of DOSLIB command 79 

of DOSLKED command 82 

of DSERV command 84 

of MACLIB command 135 

of PSERV command 147 

of RSERV command 166 

of SSERV command 177 

of TAPE command 192 

of TXTLIB command 200 

of UPDATE command 205 
TERMINAL 
operand 

of ASSGN command 37 

of FILEDEF command 96 
option, of ASSEMBLE command 34 
terminals 

displaying lines at, HRTERM macro 339 
output 

determine if terminal is displaying 
301 

halting 217 

restoring 218 
reading data from, RDTERM macro 332 
waiting for I/O to complete, HAITT macro 
337 
TEST option, of ASSEMBLE command 34 



testing 

return codes from CMS commands, in an 

EXEC procedure 301 
variable symbols in an EXEC procedure 
288 
TEXT 

assembler output ddname 36 
files 

automatic loading 126 
cards read by the loader 127 
creating with the assembler 34 
executing, with the RUN command 168 
link-editing in CMS/DOS 81,82 
linking in storage 125 
loading into virtual storage 125 
resolving unresolved refereces with 
the LOAD command 126 
libraries (see TXTLIB) 
operand, of LINEDIT macro 318 
TEXTA operand, of LINEDIT macro 319 
TIME, operand of &CONTROL control statement 

283 
time information, displaying during EXEC 

processing 294 
time-of-day, displaying during EXEC 

processing 283 
timer, virtual interval 170 
TO 

operand, of $MOVE edit macro 262 
option, of GENMOD command 108 
tokens 279 

TOLABEL option, of COPYFILE command 44 
TOP 

operand of &G0T0 control statement 287 
subcommand, description 253 
trace information, halting recording of 

216 
tracing 

resuming after temporarily halting 217 
suspending recording temporarily 218 
SVC instructions 182 
trailing fill characters, removing from 

records 49 
TRANS option, of COPYFILE command 45 
transferring 

CMS files, using the DISK DUMP command 

66 
control in an EXEC procedure 
&G0T0 control statement 287 
&SKIP control statement 292 
transient 
area 

CMS commands that execute in 16 
creating modules to execute in 110 
loading programs into 125 
directories in DOS/VS, displaying 84 
translate 
tables 

defining input characters for 

translation 171 
defining output characters for 

translation 171 
displaying 154 
translating 

character representations 

with the ALTER subcommand 220 
with the COPYFILE command 50 
characters 50 
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lowercase letters to uppercase letters, 
with the PRINT command 144 
translation list, for COPYFILE command, 

description 51 
TRTCH option 

of ASSGN command 38 
of FILEDIJF command 99 
of TAPE command 192 
TRUNC 

option of COPYFILE command 45 

example 48 
subcommand, description .253 
truncating 

commands 14 

input records with the editor, default 

settings 254 
records in a CMS file 45 
records in a file 

during GETFILE subcommand 233 
following a CHANGE subcommand 224 
tokens in an EXEC procedure 279 
trailing blanks from a CMS file 45 
truncation 

column, for input mode 254 
settings used by the editor 254 
truncations 

determine whether truncations are 

accepted for command names 153 
make command abbreviations acceptable as 

input 172 
make command abbreviations unacceptable 
as input 172 
two-color ribbon, controlling use of 

154,172 
TXTLIB 

command 

ADD operand 200 
DEL operand 200 
description 200 
GEN operand 200 
MAP operand 200 
files 

adding members 200 
creating 200 
deleting members 200 
determining which TXTLIBs are 

searched 157 
identify for LOAD and INCLUDE command 

processing 111 
listing members in 200 
maximum number of members 201 
searched during INCLUDE command 

processing 113 
searched during LOAD command 

processing 125 
search for unresolved references 126 
operand, of GLOBAL command 111 
operand of CMS QUERY command 157 
TXTLIB command 

DISK option 200 
PRINT option 200 
TERM option 200 
TYPE 

command 

COL option 202 
description 202 
HEX option 202 
MEMBER option 203 



function statement of DDR command 59 
operand, of &TIME control statement 294 
option 

of COPYFILE command 44 

of COPYFILE command (example) 48 

of ERASE command 88 

of INCLUDE command 114 

of LOAD command 126 

of RENAME command 164 
subcommand, description 254 
TYPE/PRINT output of DDR command 61 
typing, error messages in red 172 



U 

U operand, of CASE subcommand 223 

UA operand 

of ASSGN command 38 
of LISTIO command 123 
unassign 

logical units in CMS/DOS 38 
system and programmer logical units in 
CMS/DOS 173 
undefined, symbols in an EXEC procedure, 

effect on SIF control statement 289 
underscore 

character, on OVERLAY subcommand 240 
data records, using backspaces 235 
meaning in command format box 15 
UNLOAD option, of DDR command INPUT/OUTPUT 

control statement 56 
UNPACK option, of COPYFILE command 45 
unpacking, CMS disk files 45 
unresolved references 

during MODULE file generation 109 
loader handling of 128 

resolving with the INCLUDE command 114 
searching for TEXT files 126 
searching TXTLIBs for 126 
UP 

operand, of $MOVE edit macro 262 
subcommand, description 255 
UPCASE option 

of ASSGN command 38 
of COPYFILE command 45 
of FILEDEF command 99 
of PRINT command 144 
UPDATE 

command 

control statements 206 

CTL option 205,210 

description 204 

DISK option 205 

error handling for 213 

INC option 205 

input files 209 

multilevel updates, examples of 212 

NOCTL option 205 

NOINC option 205 

NOREP option 204 

N0SEQ8 option 205 

NOSTK option 205 

NOSTK option of 212 

NOTERM option 205 

output files 210 

PRINT option 205 

REP option 204 



378 IBM VM/370: CMS Command and Macro Reference 



SEQ8 option 204 
STK option 205,212 
STOR option 205 
TERM option 205 
warnings by 213 
control statements 
comments 209 
DELETE 208 
INSERT 207 
REPLACE 208 
SEQUENCE 206 
filetype, default editor settings 343 
option of the TAPPDS command 198 
update log 

for UPDATE command operations 205 
generating at your terminal 205 
updating 

CMS files, FSWRITE macro 313 
master file directory 162 
source files 204 
UPDIRT option, of RENAME command 164 
uppercase letters 

converting to lowercase 45 
meaning in command format boxes 15 
suppress translation of lowercase 
letters with the editor 223 
UPSI 
byte 

guery the setting of 158 
setting 173 
operand of CMS QUERY command 158 
operand of CMS SET command 173 
UPTDxxxx filetype, default editor settings 

343 
user catalog 

identifying 77 
in CMS/DOS 73 
user file directory 26 
contents of 27 
creating 26 
writing on disk 162 
user-defined synonyms, displaying 156 
user-written commands 

assigning synonyms for 186 
creating 109 



V 
valid 

characters in CMS usage 14 
CMS commands in CMS subset 226 
virtual disk addresses 26 
variable data 

in an EXEC procedure 
displaying 295 
punching 290 
stacking 293 
variable symbols 

assigning values to in EXEC procedures 

278 
reading from the terminal or console 

stack, in an EXEC procedure 291 
substituting 278 
variable-length files 

converting to fixed-length 48 

using the RECFM subcommand 242 



VARS operand of &READ control statement 

291 
verification setting, for the editor, 

changing 256 
VERIFY subcommand, description 256 
verifying 

changes made by the editor 256 
existence of a CMS file, FSSTATE macro 

311 
existence of a file 180 
existence of CMS file, during program 
execution 308 
virtual disks (see also disks) 
counting cylinders on 104 
initializing 104 
resetting the number of cylinders on 

104 
valid addresses for 26 
virtual machine 

components of 11 
console 11 
definition 11 
virtual machine environment, determining 

the status of 152 
VM/370, basic description 11 
VSAM 

catalogs 

determining which catalog is searched 

74 
identifying 77 
identifying in CMS/DOS 73 
determining freespace extents 116 
files 

specifying disk extents 75 
specifying disk extents in CMS/DOS 
72 
master catalog 

identifying 77 
identifying in CMS/DOS 73 
option 

of DLBL command 69 
of the SET DOS ON command 173 
restrictions 

for DOS/VS users 345 
for OS/VS users 347 
VSBASIC, filetype, default editor settings 

343 
VSBASIC files, renumbering 243 
VSBDATA filetype, default editor settings 
343 



wait, for terminal I/O to complete, WAITT 

macro 337 
WAITD macro 

description 336 
ERROR operand 336 
used with HNDINT macro 315 
WAITT macro, description 337 
writing 

CMS files 

during program execution 3 12 
seguentially 313 
CMS files to disk 229 

during an edit session 221,248 
comments in VM/370 13 
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labels on CMS disks 104 

nonreentrant code for LINEDIT macro 

records on tape, WRTAPE macro 337 

reentrant code for the LINEDIT macro 
326 

tape files to disk 191 
WRTAPE macro 

description 337 

ERROR operand 338 

MODE operand 337 
WRTERM macro 

COLOR operand 339 

description 339 

EDIT operand 339 
HTM 

option of TAPE command 192 

tape control function 191 



1 
327 19E virtual disk address, accessed as 
Y-disk 27 

190 virtual disk address, accessed as 
S-disk 27 

191 virtual disk address, accessed as 
A-disk 27 

192 virtual disk address, accessed as 
D-disk 27 

195 virtual disk address, formatted by CMS 
Batch Facility 40 



3350, restriction on use in CMS/DOS 39 



X 
X 

DEBUG subcommand 275 

EDIT subcommand 

description 257 
example 257 
XREF option 

of ASSEMBLE command 33 

of OPTION command 142 
XTENT option, of FILEDEF command 98 



Y subcommand 

description 257 

example 257 
Y-disk, accessed after IPLing CMS 27 
YFLAG option, of ASSEMBLE command 35 



48C, option, of OPTION command 142 



60C, option, of OPTION command 142 



7TRACK option 

of ASSGN command 38 

of FILEDEF command 99 

of TAPE command 192 
7-track tapes, specifying on the TAPE 
command 192 



zone settings, for an edit session 258 
ZONE subcommand, description 258 



9TRACK option 

of ASSGN command 38 

of FILEDEF command 99 

of the TAPE command 192 
9-track tapes, specifying on the TAPE 
command 192 
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